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ABSTRACT 


Interoperability  between  software  systems  is  the 
ability  to  exchange  services  from  one  system  to  another.  In 
order  to  exchange  services,  data  and  commands  are  relayed 
from  the  service  providers  to  the  requesters.  Presently, 
there  are  some  interoperability  techniques  that  aid  the 
exchange  of  information,  ranging  from  low-level  sockets  and 
messaging  techniques  to  more  sophisticated  middleware' 
technology  like  object  resource  brokers  (CORBA,  DCOM) . 
Middleware  technology  uses  higher  abstraction  than 
messaging,  and  can  simplify  the  construction  of 
interoperable  applications.  It  provides  a  bridge  between  the 
service  provider  and  requester  by  providing  standardized 
mechanisms  that  handle  communication,  data  exchange  and  type 
marshalling.  However,  in  current  interoperability 
techniques,  data  and  services  are  tightly  coupled  to  a 
particular  server.  Furthermore,  most  developers  are  trained 
in  developing  stand-alone  applications  rather  than 
distributed  applications.  This  thesis  aims  at  developing  a 
generic  interface  wrapper  that  can  be  used  to  separate  the 
data  and  services  from  the  server,  and  allows  the  developers 
to  treat  distributed  data  and  services  as  those  they  are 
local  within  an  application  process  space.  In  addition,  the 
research  developed  a  program  to  fully  automate  the  process 
of  generating  the  interface  wrapper  directly  from  a 
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specification  language  such  as  Prototype  System  Description 
Language  (PSDL) . 
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I. 


INTRODUCTION 


A.  BACKGROUND 

Interoperability  between  software  systems  is  the 
ability  to  exchange  services  from  one  system  to  another.  In 
order  to  exchange  services,  data  and  commands  are  relayed 
from  the  service  providers  to  the  requesters .  Current 
business  and  military  systems  are  typically  2-tier  or  3-tier 
systems  involving  clients  and  servers,  each  running  on 
different  machines  in  the  same  or  different  locations. 
Current  approaches  for  n-tier  systems  have  no 
standardization  of  protocol,  data  representation,  invocation 
techniques  etc.  Other  problems  with  interoperability  are  the 
implementation  of  distributed  systems  and  the  use  of 
services  from  heterogeneous  operating  environments.  These 
include  issues  concerning  sharing  of  information  amongst 
various  operating  systems,  and  the  necessity  for  evolution 
of  standards  for  using  data  of  various  types,  sizes  and  byte 
ordering,  in  order  to  make  them  suitable  for  interoperation. 
These  problems  make  interoperable  applications  difficult  to 
construct  and  manage. 

B.  CURRENT  STATE-OF-THE-ART  SOLUTIONS 

Presently,  the  solutions  attempting  to  address  these 
interoperability  problems  range  from  low-level  sockets  and 
messaging  techniques  to  more  sophisticated  middleware 
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technology  like  object  resource  brokers  (CORBA,  DCOM) . 
Middleware  technology  uses  higher  abstraction  than 
messaging,  and  can  simplify  the  construction  of 
interoperable  applications.  It  provides  a  bridge  between  the 
service  provider  and  requester  by  providing  standardized 
mechanisms  that  handle  communication,  data  exchange  and  type 
marshalling.  The  implementation  details  of  the  middleware 
are  generally  not  important  to  developers  building  the 
systems.  Instead,  developers  are  concerned  with  service 
interface  details.  This  form  of  information  hiding  enhances 
system  maintainability  by  encapsulating  the  communication 
mechanisms  from  the  developers  and  providing  a  stable 
interface  services  for  the  developers.  However,  developers 
still  need  to  perform  significant  work  in  incorporating  the 
middleware's  services  into  their  systems.  Furthermore,  they 
must  have  a  good  knowledge  of  how  to  deploy  the  middleware 
services  to  fully  exploit  the  features  provided. 

Current  middleware  approaches  have  another  major 
limitation  in  the  design  -  the  data  and  services  are  tightly 
coupled  to  the  servers.  Any  attempt  to  parallelize  or 
distribute  a  computation  across  several  machines  therefore 
encounters  complicated  issues  due  to  this  tight  control  of 
the  server  process  on  the  data. 
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C.  MOTIVATION 

Distributed  data  structures  provide  an  entirely 
different  paradigm.  Here,  data  is  no  longer  coupled  to  any 
particular  process.  Methods  and  services  that  work  on  the 
data  are  also  uncoupled  from  any  particular  process. 
Processes  can  now  work  on  different  pieces  of  data  at  the 
same  time.  So  far,  building  distributed  data  structures 
together  with  their  requisite  interface  has  proved  to  be 
more  daunting  than  other  conventional  interoperability 
middleware  techniques .  The  arrival  of  JavaSpace  has  changed 
the  scenario  to  some  extent.  It  allows  easy  creation  and 
access  of  distributed  objects.  However,  issues  concerning 
data  getting  lost  in  the  network,  duplicated  data  items, 
out-dated  data,  external  exception  handling  and  handshaking 
of  communication  between  the  data  owner  and  data  users  are 
still  open.  The  developers  have  to  devise  ways  to  solve 
those  problems  and  standardize  them  between  applications. 

D .  PROPOSAL 

The  situation  concerning  interoperability  would  greatly 
improve  if  a  developer  working  on  some  particular 
application  were  provided  with  the  features  capable  of 
treating  distributed  objects  as  local  objects  within  the 
application.  The  developers  could  then  modify  the 
distributed  object  as  if  it  is  local  within  the  process.  The 
changes  may,  however,  still  need  to  be  reflected  on  other 
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applications  using  that  distributed  object  without  creating 
any  problems  related  to  inconsistency.  The  present  thesis 
aims  at  attaining  this  objective  by  creating  a  model  of  an 
interface  wrapper  that  can  be  used  for  a  variety  of 
distributed  objects.  In  addition,  by  automating  the  process 
of  generating  the  interface  wrapper  directly  from  the 
interface  specification  of  the  requirement,  developers' 
productivity  is  greatly  improved. 

The  tool ,  named  the  Automated  Interface  Codes  Generator 
(AICG) ,  has  been  developed  to  generate  the  interface  wrapper 
codes  for  interoperability,  from  a  specification  language 
called  the  Prototype  System  Description  Language  (PSDL) 
[LUQ88]  .  The  tool  uses  the  principles  of  distributed  data 
structure  and  JavaSpace  Technology  to  encapsulate 
transaction  control,  synchronization,  and  notification 
together  with  lifetime  control  to  provide  an  environment 
that  treats  distributed  objects  as  if  there  were  local 
within  the  concerned  applications. 
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II.  REVIEW  OF  EXISTING  WORKS: 


A.  ORB  APPROACHES 

A  basic  idea  for  enhancing  interoperability  is  to  make 
the  network  transparent  to  the  application  developers.  The 
existing  approaches  [BER99]  include  1) Building  blocks  for 
interoperability,  2)  Architectures  for  unified,  systematic 
interoperability  and  3)  Packaging  for  encapsulating 
interoperability  services.  These  approaches  have  been 
assessed  using  the  Kiviat  graphs  by  Berzins  [BER99]  with 
various  weight  factors .  The  Kiviat  graphs  give  a  good 
summary  of  the  strong  and  weak  points  of  various  approaches. 
ORB  and  Jini  are  currently  the  more  promising  technologies 
for  interoperability. 

There  are  however,  some  concerns  with  the  ORB  models. 
Sullivan  [SUL99]  provides  a  more  in-depth  analysis  of  the 
DCOM  model,  highlighting  the  architecture  conflicts  between 
Dynamic  Interface  Negotiation  (how  a  process  queries  a  COM 
services  and  interface)  and  Aggregation  (component 
composition  mechanism) .  The  interface  negotiation  does  not 
function  properly  within  the  aggregated  boundaries.  This 
problem  arises  out  of  the  sharing  of  an  interface  by  the 
components.  An  interface  is  shared  if  the  constructor  or 
Querylnterface  functions  of  several  components  can  return  a 
pointer  to  it .  Querylnterface  rules  state  that  a  holder  of  a 
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shared  interface  should  be  able  to  obtain  interfaces  of  all 
types  appearing  on  both  the  inner  and  outer  components . 
However,  an  aggregator  can  refuse  to  provide  interfaces  of 
some  types  appearing  on  an  inner  component  by  hiding  the 
inner  component.  Thus,  Querylnterface  fails  to  work  properly 
with  respect  to  delegation  to  the  inner  interface. 

Hence,  for  the  ORB  approaches,  detailed  understanding 
of  the  techniques  is  required  to  design  a  truly  reliable 
interoperable  system.  Programmers  however,  are  trained 
mostly  on  standalone  programming  techniques .  Addition  of 
specialized  network  programming  models  increases  the 
learning  as  well  as  development  time,  with  occasional 
slippage  of  target  deadlines.  Furthermore,  bugs  in  the 
distributed  programs  are  harder  to  detect  and  consequences 
of  failure  are  more  catastrophic.  An  abnormal  program  may 
cause  other  programs  to  go  astray  in  a  connected  distributed 
environment  [LUQ88] ,  [LUQ98] . 

B .  PROTOTYPING 

The  demand  for  large,  high  quality  systems  has 
increased  to  the  point  where  a  quantum  change  in  software 
technology  is  needed  [LUQ88]  .  Rapid  prototyping  is  one  of 
the  most  promising  solutions  to  this  problem.  Completely 
automated  generation  of  prototype  from  a  very  high-level 
language  is  feasible  and  in- fact  generation  of  skeleton 
programming  structures  is  very  common  in  the  computer  world. 
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One  major  advantage  of  the  automatic  generation  of  codes  is 
that  it  frees  the  developers  from  the  implementation  details 
by  executing  specification  via  reusable  components  [LUQ88] . 

In  this  perspective,  an  integrated  software  development 
environment,  named  Computer  Aided  Prototyping  System  (CAPS) 
has  been  developed  at  the  Naval  Postgraduate  School,  for 
rapid  prototyping  of  hard  real-time  embedded  software 
systems,  such  as  missile  guidance  systems,  space  shuttle 
avionics  systems,  and  military  Command,  Control, 
Communication  and  Intelligence  (C3I)  systems  [LUQ92] .  Rapid 
prototyping  uses  rapidly  constructed  prototypes  to  help  both 
the  developers  and  their  customers  visualize  the  proposed 
system  and  assess  its  properties  in  an  iterative  process. 
The  heart  of  CAPS  is  the  Prototype  System  Description 
Language  (PSDL) .  It  serves  as  an  executable  prototyping 
language  at  the  specification  or  design  level  and  has 
special  features  for  real-time  system  design.  Building  on 
the  success  of  computer  aided  rapid  prototyping  system 
(CAPS)  [LUQ92]  ,  the  AICG  model  also  uses  the  PSDL  for  the 
specification  and  automates  the  generation  of  interface 
codes  with  the  objective  of  making  the  network  transparent 
from  the  developer's  point  of  view. 

C .  TRANSACTION  HANDLING 

Building  a  networked  application  is  quite  different 
from  building  a  stand-alone  system  in  the  sense  that  many 
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additional  issues  need  to  be  taken  care  of  for  smooth 
functioning  of  a  networked  application.  The  networked 
systems  are  also  susceptible  to  partial  failures  of 
computation,  which  can  leave  the  system  in  an  inconsistent 
state . 

Proper  transaction  handling  is  essential  to  control  and 
maintain  concurrency  and  consistency  within  the  system.  Yang 
[YAN99] ,  examined  the  limitation  of  hard-wiring  concurrency 
control  (CC)  into  either  the  client  or  the  server.  He  found 
that  the  scalability  and  flexibility  of  these  configurations 
is  greatly  limited.  Hence,  he  presented  a  middleware 
approach:  an  external  transaction  server,  which  carries  out 
the  concurrency  control  policies  in  the  process  of  obtaining 
the  data.  Advantages  of  this  approach  are  1)  transaction 
server  can  be  easily  tailored  to  apply  the  desired  CC 
policies  of  specific  client  applications.  2)  The  approach 
does  not  require  any  changes  to  the  servers  or  clients  in 
order  to  support  the  standard  transaction  model.  3) 
Coordination  among  the  clients  that  share  data  but  have 
different  CC  policies  is  possible  if  all  of  the  clients  use 
the  same  transaction  server. 

The  AICG  model  uses  the  same  approach,  by  deploying  an 
external  transaction  manager  provided  by  SUN  in  the  JINI 
model  [ JOY99]  .  All  transactions  used  by  the  clients  and 
servers  are  created  and  overseen  by  the  manager. 
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III.  THE  BASIC  MODEL 


A.  JAVASPACE  MODEL 

JavaSpace  model  is  a  high-level  coordination  tool  for 
gluing  processes  together  in  a  distributed  environment.  It 
departs  from  conventional  distribution  techniques  using 
message  passing  between  processes  or  invoking  methods  on 
remote  objects.  The  technology  provides  a  fundamentally 
different  programming  model  that  views  an  application  as  a 
collection  of  processes  cooperating  via  the  flow  of  freshly 
copied  objects  into  and  out  of  one  or  more  spaces.  This 
space-based  model  of  distributed  computing  has  its  roots  in 
the  Linda  coordination  language  [GEL85]  developed  by  Dr. 
David  Gelernter  at  Yale  University. 

A  space  is  a  shared,  network-accessible  repository  for 
objects.  Processes  use  the  repository . as  a  persistent  object 
storage  and  exchange  mechanism.  As  shown  in  figure  1, 
processes  perform  simple  operations  to  write  new  objects 
into  space,  take  objects  from  space,  or  read  (make  a  copy 
of)  objects  in  a  space.  While  taking  or  reading  objects, 
processes  use  a  simple  value -matching  lookup  to  find  the 
objects  that  matter  to  them.  If  a  matching  object  is  not 
found  immediately,  then  a  process  can  wait  until  one 
arrives.  Unlike  conventional  object  stores,  processes  do  not 
modify  objects  in  the  space  or  invoke  their  methods 
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storage  for  objects.  Once  stored  in  the  space,  an 
object  will  remain  there  until  a  process 
explicitly  removes  it. 
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•  Spaces  are  transactionally  secure:  The  Space 
technology  provides  a  transaction  model  that 
ensures  that  an  operation  on  a  space  is  atomic. 
Transactions  are  supported  for  single  operations 
on  a  single  space,  as  well  as  multiple  operations 
over  one  or  more  spaces . 

•  Spaces  allow  exchange  of  executable  content:  While 
in  the  space,  objects  are  just  passive  data. 
However,  when  we  read  or  take  an  object  from  a 
space,  a  local  copy  of  the  object  is  created.  Like 
any  other  local  object,  we  can  modify  its  public 
fields  as  well  as  invoke  its  methods. 

B.  AICG  MODEL 

The  interoperability  approach  underlying  the  AICG 
model,  proposes  a  tool  for  building  distributed 
applications.  The  tool  is  designed  to  generate  interface 
wrappers  for  data  structures  or  objects  that  need  to  be 
shared,  and  are  particularly  useful  for  applications  that 
can  model  as  flows  of  objects  through  one  or  more  servers. 
Build  on  top  of  JavaSpace,  the  AICG  model  hides  the  space 
and  its  implementation  details  entirely  from  the 
application.  The  interface  wrapper  allows  applications  to 
treat  distributed  data  structures  or  objects  as  local  within 
the  application  space.  This  enhances  interoperability  by 
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making  the  network  transparent  to  the  application 
developers . 

The  interface  wrappers  are  generated  from  an  extension 
of  a  prototype  description  language  called  Prototype  System 
Description  Language  (PSDL) . 

Some  of  the  salient  features  of  the  AICG  model  are: 

•  Distributed  objects  are  treated  as  local  objects 
within  the  application  process.  The  application 
codes  need  not  depend  on  how  the  object  is 
distributed,  since  the  local  object  copy  is  always 
synchronous  with  the  distributed  copy.  (Chapter  V) 

•  Synchronization  with  various  applications  is 
automatically  handled.  Since  the  AICG  model  is 
based  on  the  space  transaction  secure  model,  all 
operations  are  atomic.  Deadlock  is  prevented 
automatically  within  the  interface  by  having  only 
a  single  distributed  copy,  and  through  transaction 
control.  (Chapter  VI,  XI) 

•  Any  type  of  object  can  be  shared  as  long  as  the 
object  is  serializable.  Any  data  structure  and 
object  can  be  distributed  as  long  as  it  obeys  and 
implements  the  java  serializable  feature  (Chapter 
VI,  Section  B-2) . 

•  Every  distributed  object  has  a  lifetime.  The 
distributed  object  lifetime  is  a  period  of  time 
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guaranteed  by  the  AICG  model  for  storage  and 
distribution  of  the  object.  The  time  can  be  set  by 
developer.  (Chapter  V,  Section  C) 

•  All  write  operations  are  transaction  secure  by 
default.  AICG  transactions  are  based  on  the 
Atomicity,  Consistency,  Isolation,  and  Durability 
(ACID)  properties.  (Chapter  V,  Section  D) 

•  Clients  can  be  informed  of  changes  to  the 
distributed  object  through  the  AICG  event  model.  A 
client  application  can  subscribe  for  change 
notification,  and  when  the  distributed  object  is 
modified,  a  separate  thread  is  spawned  to  execute 
the  callback  method  defined  by  the  developer. 
(Chapter  V,  Section  E) 

•  The  wrapper  codes  are  generated  from  high-level 
descriptive  languages;  hence,  they  are  more 
manageable  and  more  maintainable. 
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IV.  DEVELOPING  DISTRIBUTED  APPLICATIONS  WITH  THE  AICG  TOOL 


This  section  describes  the  steps  for  developing 
distributed  applications  using  the  AICG  model .  An  example  of 
a  C4ISR  application  is  introduced  in  section  4.1.2  to  aid 
the  explanation  of  the  process.  The  same  example  will  be 
used  throughout  this  paper. 

A.  DEVELOPMENT  PROCEDURES 

The  developer  starts  the  development  process  by 
defining  shared  objects  using  the  Prototype  System 
Description  Language  (PSDL) .  The  PSDL  is  processed  through  a 
code  generator  (PSDLtoSpace)  to  produce  a  set  of  interface 
wrapper  codes  (figure  2) .  The  interface  wrapper  contains  the 
necessary  codes  for  interaction  between  the  applications  and 
the  space  without  the  need  for  the  developers  to  be 
concerned  with  the  writing  and  removing  of  objects  in  the 
space.  The  developers  can  treat  shared  or  distributed 
objects  as  local  objects,  where  synchronization  and 
distribution  is  automatically  handled  by  the  interface 
codes . 


Figure  2,  PSDL  to  Space 


15 


Figure  3,  Generating  the  interface  codes 
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The  complete  cycle  for  generating  the  interface  codes 
is  shown  in  figure  3 . 

B.  INPUT  DEFINITION  TO  THE  CODE  GENERATOR 

The  following  example  demonstrates  the  development  of 
one  of  the  many  distributed  objects  in  the  C4ISR  system. 
Airplane  positions  picked  up  from  the  sensors  are  processed 
to  produce  track  objects.  These  objects  are  distributed  over 
a  large  network  and  used  by  several  clients'  stations  for 
displaying  the  positions  of  planes.  Each  track  or  plane  is 
identified  by  track  number.  The  tracks  are  'owned'  by  a 
group  of  track  servers,  and  only  the  track  servers  can 
update  the  track  positions  and  its  attributes.  The  clients 
only  have  read  access  on  the  track  data.  Figure  4  shows  the 
PSDL  codes  for  the  track  object  and  its  methods.  Figure  5 
shows  the  PSDL  codes  for  the  Track_list  object  and  its 
methods . 

The  PSDL  grammar  used  for  the  AICG  is  an  extended 
version  of  the  original  PSDL  grammar  (Appendix  A)  .  PSDL 
model  is  very  extensive  and  can  be  used  to  model  an  entire 
distributed  system.  However,  the  AICG  only  used  a  portion  of 
the  PSDL  to  describe  the  interface  between  systems .  In 
another  word,  interactions  between  applications  are  defined 
using  the  PSDL  but  not  the  application  itself.  Because  of 
this,  slight  modifications  on  the  PSDL  grammar  were  needed. 
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The  complete  listing  of  the  changes  in  the  grammar 
statements  can  also  be  found  in  Appendix  A. 

The  track  PSDL  starts  with  the  definition  of  a  type 
calle<3  track.  It  has  only  one  identification  field 
tracknumber .  Of  course,  the  track  objects  can  have  more  than 
one  field,  but  only  one  field  is  in  this  case  is  used  to 
uniquely  identify  any  particular  track  object.  The  type 
track_list  shown  in  figure  5,  on  the  other  hand,  does  not 
need  an  identification  field  since  there  is  only  one 
track_list  object  in  the  whole  system.  Track_list  is  used  to 
keep  a  list  of  all  the  active  tracks  tracknumber  in  the 
system  at  that  moment  in  time. 

All  the  operators  (methods)  of  the  type  are  defined 
immediately  after  the  specification.  Each  method  has  a  list 
of  input  and  output  parameters  that  define  the  arguments  of 
the  method.  The  most  important  portion  in  the  method 
declaration  is  the  implementation.  The  developer  must  be 
able  to  define  the  type  of  operation  the  method  is  supposed 
to  perform.  The  operations  are  constructor  (used  to 
initialize  the  class) ,  read  (no  modification  to  any  field  in 


the  class) 

and 

write  (modification 

is  done  to  one 

or 

more 

fields  in 

the 

class) .  These  are 

necessary,  as 

the 

code 

generated 

will 

encapsulate  the 

synchroni za t ion 

of 

the 

distributed  objects. 
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Type  track 

OPERATOR  setPosition 

SPECIFICATION 

SPECIFICATION 

tracknumber:  integer 

INPUT  post :  positionjype 

END 

END 

OPERATOR  track 

IMPLEMENTATION 

SPECIFICATION 

SPACE 

INPUT  x:integer 

PROPERTY  SPACEMODE  =  WRITE 

END 

PROPERTY  TRANSACTIONTIME  = 

IMPLEMENTATION 

2000 

SPACE 

END 

PROPERTY  SPACEMODE= 

END 

CONSTRUCTOR 

END 

OPERATOR  getPosition 

END 

SPECIFICATION 

OPERATOR  getID 

OUTPUT  post :  position  type 

END 

SPECIFICATION 

IMPLEMENTATION 

OUTPUT  x:  integer 

SPACE 

END 

PROPERTY  SPACEMODE  =  READ 

IMPLEMENTATION 

SPACE 

END 

PROPERTY  SPACEMODE-  READ 

END 

IMPLEMENTATION 

END 

SPACE 

OPERATOR  setCallsign 

PROPERTY  SPACENAME=  DODSpaces 
PROPERTY  OWNERSHIP  =  YES 

SPECIFICATION 

PROPERTY  SECURITY  =  SERVER 

INPUT  sign:  string 

PROPERTY  LEASE  =  12000 

END 

PROPERTY  CLONE  =  MANY 

IMPLEMENTATION 

PROPERTY  NOTIFY  =  NO 

SPACE 

PROPERTY  RETRY  =  10 

PROPERTY  SPACEMODE=  WRITE 

END 

PROPERTY  TRANSACTIONTIME  = 

300 

END 

END 

OPERATOR  getCallsign 

SPECIFICATION 

OUTPUT  sign:  string 

END 

IMPLEMENTATION 

SPACE 

PROPERTY  SPACEMODE=  READ 

END 

END 

Figure  4,  Track  example  in  PSDL 
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IMPLEMENTATION 

TYPE  track  list 

SPACE 

SPECIFICATIO 

PROPERTY  SPACENAME=  DODSpaces 

END 

PROPERTY  OWNERSHIP  =  YES 

PROPERTY  SECURITY  =  SERVER 

OPERATOR  track  list 

PROPERTY  LEASE  =0 

SPECIFICATION 

PROPERTY  CLONE  =  ONE 

END 

PROPERTY  NOTIFY  =  YES 

IMPLEMENTATION 

PROPERTY  RETRY  =  5 

SPACE 

END 

PROPERTY  SPACEMODE= 

CONSTRUCTOR 

END 

TYPE  position  type 

END 

SPECIFICATION 

END 

OPERATOR  getDD 

IMPLEMENTATION  JAVA  position.java 

SPECIFICATION 

END 

INPUT  index:  integer 

OUTPUT  xrinteger 

END 

IMPLEMENTATION 

SPACE 

PROPERTY  SPACEMODE=  READ 

END 

END 

OPERATOR  setNewID 

SPECIFICATION 

INPUT  id:  integer 

END 

IMPLEMENTATION 

SPACE 

PROPERTY  SPACEMODE=  WRITE 

END 

END 

OPERATOR  removelD 

SPECIFICATION 

INPUT  id:  integer 

END 

IMPLEMENTATION 

SPACE 

PROPERTY  SPACEMODE=  WRITE 

PROPERTY  TRANSACTIONTIME  = 

2000 

END 

END 

END 

Figure  5,  Track  list  example  PSDL 


The  other  field  in  the  implementation  portion  of  the 
method,  is  transactiontime.  transactiontime  defines  the 
upper  limit  in  milliseconds  within  which  the  operation  must 
be  completed.  The  transaction  property  is  discussed  in 
detail  in  Chapter  VI,  Section  D.  Method  Implementation 
property  fields  inlcude: 

SPACEMODE  =  CONSTRUCTOR/  :  Type  of  operation 
READ  /WRITE 

TRANSACTIONTIME  =  999  :  Upper  limit  of  the  operation 

:  in  ms. 

:  Transaction  is  disabled  by 
:  setting  the  value  to  0. 

At  the  end  of  each  class  is  the  implementation  section. 
•This  section  is  the  class-wide  attributes  of  the  ACIG 
properties.  The  explanation  of  the  attributes  is: 


SPACENAME=  DODSpaces 
OWNERSHIP  =  YES/NO 


SECURITY  =  SERVER 


/Client 


Which  Java  Space  to  be  used 
Every  object  has  at  most  one 
owner? 

Only  Server  application  can 
modify  the  object 
All  application  can  modify 
the  object 
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LEASE 


=  999 


CLONE  =  ONE 


/MANY 


NOTIFY  =  YES 


/NO 


RETRY  =  n 


Object  life  time  in  ms.  For 
lease  that  last  forever,  set 
it  to  0 

There  is  only  one  object  of 
this  type 

in  the  space  at  a  time 
There  can  be  many  object  of 
the  this  type  in  the  space 
simultaneously. 

Notification  of  changes 
allowed. 

Notification  of  changes  not 
allowed. 

Retry  all  communication 
operations  on  the  space  for 
n  times,  before  raising  an 
exception. 
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C.  RUNNING  THE  PSDL2 SPACE  PROGRAM 

Each  distributed  class  in  the  PSDL  will  generate  a  set 
of  interface  wrapper  files  after  executing  the  PSDL2Space 
program . 

The  command  line  for  PSDL2Space  is: 

•  PSDL2Space  destination  dir>  data  dir>  <psdl  file> 
Figure  6  below  shows  the  files  created  for  executing 
the  command: 


C : >  PSDL2Space  interf aceAICG  aicgDir  track. psdl 


EntryAICG,  GlobalAICG,  ExceptionAICG,  TrackEntry, 

SpaceAICG,  Event AICGID ,  trackExt,  track, 

EventAICGHandler ,  TrackExtClient , 


NotifyAICG,  TransactionAICG,  TrackExtServer 

TransactionManager 


Fixed  name  files  generated 
to  support  the  AICG  model . 


>  v _  _ j 


n 


File  name  start  with  the  object 
name  followed  by  AICG  type,  such 
as  Ext ,  Ext Client ,  Ext Server 


Figure  6,  AICG  generated 
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Most  of  the  generated  files  can  be  ignored  except  the 
following : 

I.  Track. java:  this  file  contains  the  skeleton  of 
the  fields  and  the  methods  of  the  track  class.  The 
user  is  supposed  to  fill  the  body  of  the  methods. 

II.  TrackExt Client .  java:  this  is  the  wrapper  class 
that  the  client  initialized  and  used  instead  of 
the  track  class. 

III.  TrackExt  Server,  java:  this  is  the  wrapper  class 
that  the  server  initialized  and  used  in  replace 
for  the  track  class. 

IV.  Not ifyAICG. java  :  this  class  must  be  extended 
or  implemented  by  the  application  if  event- 
notification  and  call-back  are  needed. 

The  methods  found  in  the  trackExtClient  and 
trackExt Server  have  the  same  method  names  and  signatures  of 
the  track  class.  In  fact,  the  track  class  methods  are  been 
called  within  trackExtClient  or  t rackExt Server . 

D.  THE  SERVER  SIDE  OF  TRACK 

Every  AICG  server  must  have  a  main  program  that 
initializes  the  AICG  environment  and  creates  the  distributed 
objects.  An  example  of  a  small  portion  of  the  server  program 
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is  given  below.  The  full  example  listing  can  be  found  in 
Appendix  B.  It  is  noted  that  the  once  the  distributed  object 
is  instantiated,  it  behaves  like  any  local  object  that  be 
invoked  or  modified. 


public  class  TrackServer  implements  Runnable 

{ 

public  void  run(){ 

//  TODO:  Add  initialization  code  here 

trackExtServer  trk[]; 

position_type  pos; 

try{ 

//  Start  the  transaction  manager 
trackExt . trackStartTxn ( ) ; 

//  create  array  of  for  10  tracks 
trk  =  new  trackExtServer [10] ; 

rd  =  new  Random () ; 

//  create  10  tracks  with  random  position 
for  (int  i=0;  i  <10;  i++) { 

//  create  the  tracks 

trk[i]  =  new  trackExtServer (i) ; 

//  generate  a  ramdom  number 
pos  =  new  position_type 

( rd . next Int ( ) , rd . next Int ( ) ) ; 

//  set  the  position 
trk[i] . setPosition (pos) ; 

} catch  (Exception  e) { 

System. err .print In ( "Exception" ) ; 
e.printStackTrace () ; 

} 

} 

} 


Figure  6,  An  example  of  Track  Server 
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E.  THE  CLIENT  SIDE  OF  TRACK  WITHOUT  EVENT -NOTIFICATION 

ENABLED 

The  client  program  example  consists  of  a  single  Java 
class,  TrackClient.  This  class  provides  the  main  method  that 
performs  only  one  main  task;  Initialize  the  trackExt Client 
object.  Of  course,  the  client  must  know  the  track  number  in 
advance  before  it  can  locate  the  distributed  object.  Since 
event-notification  is  not  enabled,  the  client  has  to  keep 
polling  on  the  contents  of  the  track.  Part  of  TrackClient  is 
shown  below  in  figure  8.  The  full  listing  of  TrackClient  is 
found  in  Appendix  B. 


public  class  TrackClient  implements  Runnable 


public  void  run(){ 

//  initialize  and  search  for  the  track  in  the  space 
try  { 

trk  =  new  trackExtClient  [10]  ,- 
//intialize  the  track  clients 
for  (int  i=0 ;  i  <10;  i++) { 

trk[i]  =  new  trackExtClient (i) ; 

} 

/ /  loop  every  6  seconds 
while  (true) { 

Thread. sleep (6000) ; 

for  (int  i  =0;  i  <10;  i++)  { 

System. out. print  ("ID  +  trk  [i]  .  getID  ( )  )  ; 
System. out .print In ( "  X  :"  + 
trk[i]  .getPosition  ()  )  ; 


}catch  (Exception  e) { 

System. err .println ( "Exception" ) ; 
e.printStackTrace () ; 


Figure  8,  Example  of  Track  Client  without  Notification 
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F.  THE  CLIENT  SIDE  OF  TRACK  WITH  EVENT-NOTIFICATION 
ENABLED 

The  client  program  is  the  same  as  the  one  above  with 
the  only  exception  is  that  the  notification  is  enabled. 
Hence,  whenever  the  server  changes  the  contents  of  the  track 
object,  listenerAICGEvents  method  will  be  invoked. 


public  class  TrackClient  implements  Runnable,  notifyAICG 

{ 

public  void  run(){ 
try{ 

//  initialize  event  notification 
handler  =  new  event AICGHandler (this) ; 

} catch  ( except ionAICG  e)  {. 

} 

try{ 

trk  =  new  trackExtClient [10] ; 

//  enable  this  track  with  notification  for  changes 
trk [i] . setEvent (handler) ; 

}  } 

//  listenerAICGEvent  will  be  invoked  when  changes  occur 
public  void  listenerAICGEvents (Object  ob j ) { 

try  {  X 

trackExtClient  trkClient  =  (trackExtClient)  obj ; 
System. out .println( "Notified  detected") ; 

System. out  .print  ("ID  +  trkClient .getID ()) ; 
System. out . println ( "Posit"  +  trkClient. 
get  Position  ()  )  ; 

} catch  (Exception  e) { 

System. err .println ("Exception") ; 

} 

} 

} 

Figure  9,  Example  of  Track  Client  with  Notification 
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V. 


CHARACTERISTICS  OF  AICG  MODEL 


A.  DISTRIBUTED  DATA  STRUCTURE  AND  LOOSELY  COUPLED 

PROGRAMMING 

Conceptually  a  distributed  data  structure  is  one  that 
can  be  accessed  and  manipulated  by  multiple  processes  at  the 
same  time  without  any  consideration  for  any  machine 
physically  executing  those  processes.  In  most  distributed 
computing  models,  distributed  data  structures  are  hard  to 
achieve.  Message  passing  and  remote  method  invocation 
systems  provide  a  good  example  of  the  difficulty.  Most  of 
the  systems  tend  to  keep  data  structure  behind  one  central 
manager  process,  and  processes  that  want  to  perform  work  on 
the  data  structure  must  "wait  in  line"  to  ask  the  manager 
process  to  access  or  alter  a  piece  of  data  on  their  behalf. 
Attempts  to  parallelize  or  distribute  a  computation  across 
more  than  one  machine  face  bottlenecks  since  data  are 
tightly  coupled  by  the  one  manager  process.  True  concurrent 
access  is  rarely  achievable. 

Distributed  data  structures  provide  an  entirely 
different  approach  where  we  uncouple  the  data  from  any 
particular  process.  Instead  of  hiding  data  structure  behind 
a  manager  process,  we  represent  data  structures  as 
collections  of  objects  that  can  be  independently  and 
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concurrently  accessed  and  altered  by  remote  processes. 
Distributed  data  structures  allow  processes  to  work  on  the 
data  without  having  to  wait  in  line  if  there  are  no 
serialization  issues. 

The  distributed  protocol  for  modification  ensures 
synchronization  by  enforcing  that  a  process  wishing  to 
modify  the  object  has  to  physically  remove  it  from  the 
space,  alter  it  and  write  it  back  to  the  space.  There  can  be 
no  way  for  more  than  one  process  to  modify  an  object  at  the 
same  time.  However,  this  does  not  prevent  other  processes 
from  overwriting  the  corrected  data.  For  example,  in  the 
normal  JavaSpace,  process  A  instead  of  performing  a  "take" 
follow  by  a  "write  operation,  the  programmer  wrote  a  "read" 
operation,  followed  by  a  "write"  operation.  This  results  in 
2  copies  of  the  object  in  the  Space.  The  AICG  model  prevents 
this  by  encapsulating  the  3  basic  commands  from  the 
developers.  All  modification  on  the  object  are  automatically 
translated  to  "take",  followed  by  "write"  and  all  operations 
that  access  the  fields  of  the  distributed  object  are 
translated  to  "read".  These  ensure  that  local  data  are  up- 
to-date  and  serialization  is  maintained  (figure  10) . 
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Creating  a  Distributed  Object 


AIGC 

Inter 

face 


Write 


0 


Reading  a  field  of  a  distributed  object 


Read 


Updating  a  distributed  object 
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(^)  Local  Object 
(^^Distributed  Object 


Figure  10,  Interaction  between  Space  through 
AICG  Interface 
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Loosely-coupled  programming  also  has  its  own 
limitations.  Distributed  objects  may  be  lost  if  a  process 
removes  it  from  the  space  and  subsequently  crashes  or  is  cut 
off  from  the  network.  Similarly,  the  system  may  enter  a 
deadlock  state  if  processes  request  more  than  one 
distributed  object  while,  at  the  same  time,  holding  on  to 
distributed  objects  required  by  other  processes.  In  cases 
like  this,  the  AICG  model  groups  multiple  operations  into  a 
transaction  to  ensure  that  either  all  operations  are 
completed  or  none  occurs,  thereby  maintaining  the  integrity 
of  the  application.  Hence,  deadlock  is  prevented  through 
transaction  control.  The  application  can  retry  the  operation 
immediately  or  wait  for  a  random  time  before  performing  the 
operation  again. 

B .  SYNCHRONIZATION 

Synchronization  plays  a  crucial  role  in  any  design  of 
distributed  application.  Inevitably,  processes  in  a 
distributed  system  need  to  coordinate  with  one  another  and 
avoid  bringing  the  system  into  an  unstable  state  such  as 
deadlock.  Creating  distributed  applications  with  AICG  can 
significantly  ease  the  burden  of  process  synchronization 
since  synchronization  is  already  built  into  the  AICG 
operations.  Multiple  processes  can  read  an  object  in  a  space 
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at  any  time,  but  when  a  process  wants  to  update  an  object, 
it  has  to  remove  it  from  the  space  and  thereby  gain 
exclusive  access  to  it  first.  Hence,  coordinated  access  to 
objects  is  enforced  by  the  AICG  interface  doing  read,  take 
and  write  operations. 

More  advanced  and  complex  synchronization  schemes  can 
be  easily  build  upon  from  the  basic  atomic  features  of  the 
AIGC  operations.  An  example  is  semaphores.  Semaphores,  a 
synchronization  construct  that  was  first  used  to  solve 
concurrency  problems  in  operating  systems,  are  commonly 
found  in  multithreaded  programming  languages,  but  are  more 
difficult  to  achieve  in  distributed  systems.  Semaphores  are 
typically  implemented  as  integer  counters  that  require 
special  language  or  hardware  support  to  ensure  the  atomic 
properties  of  the  UP  (signal)  and  DOWN  (wait)  operations. 
Using  AIGC  space  model,  we  could  easily  implement  a 
semaphore  as  a  shared  variable  that  holds  an  integer 
counter.  By  assigning  a  distributed  variable  or  object  as  a 
semaphore,  groups  of  distributed  objects  can  be 
synchronized.  Hence,  the  AIGC  model  permits  the  developers 
to  develop  more  complicated  distributed  applications  without 
being  concerned  about  synchronization  and  deadlock. 
Furthermore,  all  operations  within  the  AICG  model  can  impose 
transaction  control  with  timeout  monitoring.  After  the 
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timeout  period,  the  transaction  would  rollback  the 
application  to  a  stable  state. 

C.  OBJECT  LIFE  TIME  (LEASES /TIMEOUT) 

Leasing  provides  a  methodology  for  controlling  the  life 


span  of 

the  distributed 

objects  in 

the  AICG  space. 

This 

allows  resources  to 

be 

freed  after 

a 

fixed  period. 
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model  is 
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in 
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of 
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fail 

thereby  disconnecting  them  from  the  resources  before  they 
can  explicitly  free  them.  In  the  absence  of  a  leasing  model, 
resources  could  grow  without  bound. 

There  are  other  constructive  ways  to  harness  the 
benefit  of  the  leasing  model  besides  using  it  as  a  garbage 
collector.  As  for  example,  in  a  real-time  system,  the  value 
of  the  information  regarding  some  distributed  objects 
becomes  useless  after  certain  deadlines.  Accessing  obsolete 
information  can  be  more  damaging  in  this  case.  By  setting 
the  lease  on  the  distributed  object,  the  AICG  model 
automatically  removes  the  object  once  the  lease  expires  or 
the  deadline  is  reached. 

JavaSpaces  allocate  resources  that  are  tied  to  leases. 
When  a  distributed  object  is  written  into  a  space,  it  is 
granted  a  lease  that  specifies  a  period  for  which  the  space 
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guarantees  its  storage.  The  holder  of  the  lease  may  renew  or 
cancel  the  lease  before  it  expires.  If  the  leaseholder  does 
neither,  the  lease  simply  expires,  and  the  space  removes  the 
entry  from  its  store. 

The  AICG  model  simplified  the  JavaSpace  lease  model 
into  two  configurations.  These  are: 

I.  Generally,  the  distributed  object  lasts  forever 
as  long  as  the  space  exists,  even  if  the 
leaseholder  (the  process  that  creates  the  object) 
has  died.  This  configuration  is  enabled  by  setting 
the  SPACE  lease  property  in  the  Implementation  to 
0. 

II.  In  the  real-time  environment,  the  distributed 
object  lasts  for  a  fixed  duration  of  x  ms 
specified  by  the  object  designer.  To  keep  the 
object  alive,  a  write  operation  must  be  performed 
on  the  object  before  the  lease  expires.  This 
configuration  is  set  through  the  SPACE  lease 
property  in  the  Implementation  to  the  time  in  ms 
required . 

Hence,  the  developer  must  provide  due  consideration 
towards  leasing  while  developing  the  application.  If  an 
object  has  a  lifetime,  it  must  be  renewed  before  it  expires. 
In  the  AICG  model,  renewal  is  done  by  calling  any  method 
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that  modifies  the  object.  If  no  modification  is  required, 
the  developer  can  consider  defining  a  dummy  method  with  the 
spacemode  set  to  "write".  Invoking  that  method  will 
automatically  renew  the  lease. 

D.  TRANSACTIONS 

The  AICG  model  uses  the  Jini  Transaction  model,  which 
provides  generic  services  concerning  transaction  processing 
in  distributed  computing  environment. 

1.  Jini  Transaction  Model 

All  transactions  are  overseen  by  a  transaction  manager. 
When  a  distributed  application  needs  operations  to  occur  in 
a  transaction  secure  manner,  the  process  asks  the 
transaction  manager  to  create  a  transaction.  Once  a 
transaction  has  been  created,  one  or  more  processes  can 
perform  operations  under  the  transaction.  A  transaction  can 
complete  in  two  ways.  If  a  transaction  commits  successfully, 
then  all  operations  performed  under  it  are  complete. 
However,  if  problems  arise,  then  the  transaction  is  aborted 
and  none  of  the  operations  occurs .  These  semantics  are 
provided  by  a  two-phase  commit  protocol  that  is  performed  by 
the  transaction  manager  as  it  interacts  with  the  transaction 
participants . 
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2 .  AICG  Transaction  Model 

AICG  model  encapsulates  and  manages  the  transaction 
procedures.  All  operations  on  the  distributed  object  can  be 
either  with  transaction  control  or  without.  Transaction 
control  operations  are  controlled  with  a  default  lease  of  2 
seconds.  This  default  value  of  leasing  time  may,  however,  be 
changed  by  the  user.  The  transaction  lease  is  kept  by  the 
transaction  manager  as  part  of  the  leased  resource,  and  when 
the  lease  expires  before  the  operation  being  committed,  the 
transaction  manager  aborts  the  transaction. 

The  AICG  model  by  default,  enables  all  transaction  for 
write  operations  and  the  transaction  lease  time  is  two 
seconds.  The  developer  can  modify  the  lease  time  through  the 
PSDL  SPACE  transactiontime  property. 

PROPERTY  transactiontime  =  0  :  Disable  transaction  for 

that  method 

/n  :  Set  the  lease  time  to  n 
milliseconds . 

No  read  operations  in  the  AICG  model  have  the 
transaction  enable.  However,  the  user  can  enable  it  by  using 
the  property  transactiontime  with  the  upper  limit  in 
transaction  time  for  the  read  operation. 
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E.  AICG  EVENT  NOTIFICATION 

In  the  distributed  and  loosely-coupled  programming 
environment,  it  is  desirable  for  an  application  to  react  to 
changes  or  arrival  of  newly  distributed  objects  instead  of 
"busy  waiting"  for  it  through  polling.  AICG  provides  this 
feature  by  introducing  a  callback  mechanism  that  invokes 
user-defined  methods  when  certain  conditions  are  met. 

Java  provides  a  simple  but  powerful  event  model  based 
on  event  sources,  event  listeners  and  event  objects.  An 
event  source  is  any  object  that  "fires"  an  event,  usually 
based  on  some  internal  state  change  in  the  object.  In  this 
case,  writing  an  object  into  space  would  generate  an  event. 
An  event  listener  is  an  object  that  listens  for  events  fired 
by  an  event  source.  Typically,  an  event  source  provides  a 
method  whereby  listeners  can  request  to  be  added  to  a  list 
of  listeners.  Whenever  an  event  source  fires  an  event,  it 
n°tifies  each  of  its  registered  listeners  by  calling  a 
method  on  the  listener  object  and  passing  it  an  event 
object . 

Within  a  Java  Virtual  machine  (JVM) ,  an  application  is 
guaranteed  not  to  miss  an  event  fired  from  within. 
Distributed  events  on  the  other  hand,  had  to  travel  either, 
from  one  JVM  to  another  JVM  within  a  machine  or  between 
machines  networked  together.  Events  traveling  from  one  JVM 
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to  another  may  be  lost  in  transit,  or  may  never  reach  their 
event  listener.  Likewise,  an  event  may  reach  its  listener 
more  than  once . 

Space-based  distributed  events  are  built  on  top  of  the 
Jini  Distributed  Event  model,  and  the  AICG  event  model 
further  extends  it.  When  using  the  AICG  event  model,  the 
space  is  an  event  source  that  fires  events  when  entries  are 
written  into  the  space  matching  a  certain  template  an 
application  is  interested  in.  When  the  event  fires,  the 
space  sends  a  remote  event  object  to  the  listener.  The  event 
listener  codes  are  found  in  one  of  the  generated  AICG 
interface  wrapper  files.  Upon  receiving  an  event,  the 
listener  would  spawn  a  new  thread  to  process  the  event  and 
invoke  the  application  callback  method.  This  allows  the 
'application  codes  to  be  executed  without  involving  the 
developer  in  the  process  of  event -management . 

There  are  a  few  steps  for  setting  up  AICG  event  for  a 
particular  application.  Firstly,  the  distributed  objects 
must  have  the  SPACE  properties  for  Notification  set  to  yes. 
One  of  the  application  classes  must  implement  (java  term  for 
inherit)  the  notifyAICG  abstract  class.  The  notifyAICG  class 
has  only  one  method,  which  is  the  callback  method.  The  user 
class  must  override  this  method  with  the  codes  that  need  to 
be  executed  when  an  event  fires.  More  details  on  the 
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implementation  of  the  notifyAICGHandler  have  been  included 
in  the  next  chapter. 
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VI .  AICG  DESIGN 


This  section  explains  the  design  of  the  AICG  and  the 
codes  that  are  generated  from  psdl2java  program.  The 
interface  wrapper  codes  examples  used  in  this  section  are 
generated  from  the  track  PSDL  of  figure  4. 

A.  AICG  ARCHITECTURE 

The  AICG  architecture  consists  of  four  main  modules: 
Interface  modules.  Event  modules.  Transaction  modules  and 
the  Exception  module.  The  interface  modules  implement  the 
distributed  object  methods  and  communicate  directly  with  the 
application.  In  reference  to  the  example,  the  interface 
modules  for  the  track. psdl  are  entryAICG,  track,  trackExt, 
tra ckEx t Client,  trackExtServer .  Instead  of  creating  the 
actual  object  (track) ,  the  application  should  instantiate 
the  interface  class  either  the  trackExtClient  or 
trackExtServer.  Event  modules  ( eventAICGID ,  evenAICGHandler, 
notifyAICG)  handle  external  events  generated  from  the 
JavaSpace  that  are  of  interest  to  the  application. 
Transaction  modules  (tr ansae tionAICG, 
transactionManagerAICG)  support  the  interface  module  with 
transaction  services.  Lastly,  the  exception  module 
(excep tionAICG)  defines  the  possible  types  of  exceptions 
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that  can  be  raised  and  need  to  be  handled  by  the 
application.  Figure  11  shows  the  architecture  of  the 
generated  interface  wrapper  and  the  interaction  with  the 
other  modules  and  the  application. 
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Each  time  the  application  instantiate  a  track  class  by 
creating  a  new  trackExtServer ,  the  following  events  take 
place  in  the  Interface: 

1. An  Entry  object  is  created  together  with  the  track 
object  by  the  trackExtServer.  The  tack  object  is 
placed  into  the  Entry  object  and  stored  in  the 
space . 

2.  Transaction  Manager  is  enabled. 

3 .  The  reference  pointer  to  trackExtServer  is 
returned  to  the  application. 

Each  time  a  method  (getID,  getCallsign,  getPosition) 
that  does  not  modify  the  contents  of  the  object  is  invoked, 
the  following  events  take  place  in  the  Interface: 

1.  When  the  application  invokes  the  method  through 
the  Interface  (trackExtServer/trackExtClient) . 

2.  The  Interface  performs  a  Space  "get"  operation  to 
update  the  local  copy. 

3.  The  method  is  then  executed  on  the  updated  copy  of 
the  object  to  return  the  value  back  to  the 
application. 
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Each  time  a  method  (setCallsign,  setPosition) ,  which 
does  modify  the  contents  of  the  object  is  invoked,  the 
following  events  take  place  in  the  Interface: 

1.  The  application  invokes  the  method  through  the 
Interface . 

2.  The  interface  performs  a  Space  "take"  operation, 
which  retrieves  the  object  from  the  space. 

3.  The  actual  object  method  is  then  invoked  to 
perform  the  modification. 

4.  Upon  completion  of  the  modification,  the  object  is 
returned  to  the  space  by  the  interface  using  a 
"write"  operation. 

B.  INTERFACE  MODULES 

The  interface  modules  consist  of  the  following  modules; 
an  entry  ( entryAICG )  that  are  stored  in  space,  the  actual 
object  ( track)  that  are  shared  and  the  object  wrapper 
( trackExt ,  trackExtClient,  trackExtServe) . 

1 .  Entry 

A  space  stores  entries.  An  entry  is  a  collection  of 
typed  objects  that  implements  the  Entry  interface.  The  base 
class  of  the  AICG  distributed  object  is  shown  in  figure  11. 
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public  abstract  class  entryAICG  implements  Entry 

{ 

//  main  identif cation  number 
public  Integer  entrylD; 


/ /  required  by  JavaSpace  default  constructor 
public  entryAICG (  )  { 

} 

public  entryAICG (int  id) { 
entrylD  =  new  Integer (id); 

} 

//  return  the  object  stored  in  the  entry 
public  abstract  Object  getObject(  ); 

} 


Figure  12,  An  example  of  entryAICG  class 

The  Entry  interface  is  empty;  it  has  no  methods  that 
have  to  be  implemented.  Empty  interfaces  are  often  referred 
to  as  "marker"  interfaces  because  they  are  used  to  mark  a 
class  as  suitable  for  some  role.  That  is  exactly  what  the 
Entry  interface  is  used  for,  to  mark  a  class  appropriate  for 
use  within  a  space . 

All  entries  in  the  AICG  extend  from  this  base  class.  It 
has  one  main  public  attribute,  an  identifier  and  an  abstract 
method  that  returns  the  obj  ect .  Any  type  of  obj  ect  can  be 
stored  in  the  entry.  The  only  limitation  is  that  the  object 
must  be  serializable.  Serializability  allows  the  java 
virtual  machine  to  pass  the  entire  object  by  value  instead 
of  by  reference.  Here  is  an  example  "track"  entry  codes 
generated  by  the  AICG  from  the  PSDL  file  in  figure  4 .  The 
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interface  contains  the  object  track  in  one  of  the  field  and 
an  ID. 


public  abstract  class  trackEntry  extends  entryAICG 

//  ID  is  required  if  there  are  more  than  one  similar  object  in 
//  the  space 
public  Integer  aicgIDl; 

//  track  object 
public  track  data; 

//  default  Constructor 
public  trackEntry () {  } 

//  Constructor  with  information  extracted  from  the  track  PSDL 
//  file. 

public  trackEntry (int  aid.  Integer  aicgIDl,  track  inData) { 

super (aid); 

data  =  inData; 

this. aicgIDl  =  aicgIDl; 

} 

public  Object  getObject(){ 
return  data; 

} 

} 


Figure  13,  An  example  of  Entry  class 


All  Entry  attributes  are  declared  as  publicly 
accessible.  Although  it  is  not  typical  of  fields  to  be 
defined  in  public  in  object-oriented  programming  style,  the 
associative  lookup  is  the  way  the  space -based  programs 
locate  entries  in  the  space.  To  locate  an  object  in  space,  a 
template  is  specified  that  matches  the  contents  of  the 
fields.  By  declaring  entry  fields  public,  it  allows  the 
space  to  compare  and  locate  the  object.  AICG  encourage 
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object-oriented  programming  style  by  encapsulating  the 
actual  data  object  into  the  entry.  The  object  attributes  can 
then  be  declared  as  private  and  made  accessible  only  through 
clearly  defined  public  methods  of  the  object. 

2.  Serialization 

Each  distributed  interface  object  is  a  local  object 
that  acts  as  a  proxy  to  the  remote  space  object.  It  is  not  a 
reference  to  a  remote  object  but  instead  a  connection  passes 
all  operations  and  value  through  the  proxy  to  the  remote 
space.  All  the  objects  must  be  serializable  in  order  to  meet 
this  objective.  The  Serializable  interface  is  "marker" 
interface  that  contains  no  methods  and  serves  only  to  mark  a 
class  as  appropriate  for  serialization.  The  Serializable 
interface  is  shown  in  figure  14  together  with  the  example  of 
track  class  implementing  the  interface. 

public  abstract  interface  Serializable  { 

//  this  interface  is  empty 

} 

//An  example  of  the  track  class  implementing  the  interface 

/ /Serializable 

public  class  track  implements  Serializable  { 

//  since  Serializable  is  a  marker  interface 
//  no  methods  need  to  be  override. 

} 

Figure  14,  Serializable  interface  class 
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3.  The  Actual  Distributed  Object 

We  now  look  at  the  actual  objects  that  are  shared 
between  the  servers  and  clients.  The  PSDL2Space  generates  a 
skeleton  version  of  the  actual  class  with  the  methods  names 
and  its  arguments.  The  body  of  the  methods  and  its  fields 
need  to  be  filled  by  the  developers.  The  track  class 
generated  is  shown  in  figure  15.  The  track  class  with  the 


body  and  fields  added  is  listed  in  Appendix  B. 


Figure  15,  An  example  of  a  distributed  class  generated  by 

PSDL2 Space 
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4.  Object  Wrapper 

Wrapping  is  an  approach  to  protecting  legacy  software 
systems  and  commercial  off-the-shelf  (COTS)  software 
products  that  require  no  modification  of  those  products 
[BER99] .  It  consists  of  two  parts,  an  adapter  that  provides 
some  additional  functionality  for  an  application  program  at 
key  external  interfaces,  and  an  encapsulation  mechanism  that 
binds  the  adapter  to  the  application  and  protects  the 
combined  components  [BER99] . 

In  this  context,  the  software  being  protected  contains 
the  actual  distributed  objects,  and  the  AICG  model  has  no 
way  of  knowing  the  behaviors  of  the  distributed  object  other 
than  the  type  of  operations  of  the  methods.  The  adapter 
intercepts  all  invocations  to  provide  additional 
functionalities  such  as  synchronization  between  the  local 
and  distributed  object,  transaction  control,  events 
monitoring  and  exceptions  handling.  The  encapsulation 
mechanism  has  been  explained  in  the  earlier  section  (AICG 
Architecture) .  Instead  of  instantiation  of  the  actual 
object,  the  respective  interface  wrapper  is  instantiated. 
Instantiating  the  interface  wrapper  would  indirectly 
instantiate  the  actual  object  as  well  as  storing  the  object 
in  the  space . 
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Three  classes  are  generated  for  every  distributed 
object.  These  are  named  with  the  object  name  appended  with 
the  following  Ext,  ExtClient,  and  ExtServer.  The  class 
hierarchy  of  the  example  is  shown  in  figure  16. 


Base  Class 


Client  Class  Server  Class 


Figure  16,  Wrapper  Hierarchy 

The  trackExtClient  class  is  initialized  by  applications 
that  have  only  read  access  on  the  distributed  object. 
Whereas,  the  trackExtServer  class  is  initialized  by 
applications  that  have  both  the  read  and  write  access  on  the 
distributed  object.  The  listing  of  the  three  files  are  found 
in  Appendix  B. 
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C .  EVENT  MODULES 

The  event  modules  consist  of  the  event  callback 
template  (notifyAICG) ,  the  event  handler  (evenAICGHandler) 
and  the  event  identification  object  (eventAICGID) . 

1.  Event  Identification  Class 

The  event  identification  class  is  used  to  distinguish 
one  event  from  others.  When  an  event  of  interest  is 
registered,  an  event  identification  object  is  created  by- 
storing  the  identification  and  the  event  source.  Together 
these  two  properties  act  to  uniquely  identify  the  event 
registration. 

The  class  has  only  two  methods,  an  'equals'  method  that 
check  if  two  event  identification  objects  are  the  same  and  a 
'to  string'  method  which  is  used  by  the  event  handler  for 
Searching  the  right  event  objects  from  the  hash  table.  The 
listing  of  the  event  identification  class  can  be  found  in 
Appendix  B. 

2 .  Event  Handler 

Event  Handler  is  the  main  body  of  the  event  operations 
in  the  AICG  model.  It  handles  registration  of  new  events, 
deletion  of  old  events,  listening  for  event  and  invoking  the 
right  callback  for  that  event.  In  fact,  the  event  handler 
consists  of  three  inner  classes  to  perform  the  above 
functions.  Events  are  stored  in  a  hash  table  with  the  event 
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identification  object  as  the  key  to  the  hash  table.  This 
allows  fast  retriever  of  the  event  object  and  the  respective 
callback  methods. 

The  event  handler  listens  for  new  events  from  the  space 
or  other  sources.  When  an  object  is  written  to  the  space,  an 
event  is  created  by  the  space  and  captured  by  all  the 
listeners.  The  event  handler  would  immediately  spawn  a  new 
thread  and  check  whether  the  event  is  of  interest  to  the 
application.  Figure  17  shows  the  portion  of  the  event 
handler  that  are  executed  when  an  event  is  received,  the 
full  listing  of  the  module  is  found  in  Appendix  B. 


//  call  when  an  external  event  is  "fired", 
public  void  run()  { 

/ /  get  the  event  id  and  source 
Object  source  =  event . getSource () ; 
long  id  =  event .get ID () ; 
long  seqN  =  event . get SequenceNumber () ; 

//  create  a  new  event  identif cation  object 
eventAICGID  keyID=  new  eventAICGID (id, source) ; 
registerAICG  tempReg; 

//  create  a  key  from  the  id  and  event  source 
String  key  =  new  String (keylD . toString ()) ; 

//  check  if  the  key  exist  in  the  hash  table  (storage) 
((tempReg  =  (registerAICG)  storage . get (key)  )  !=null) 

//  check  if  the  event  is  an  old  or  duplicate  event 
if  (seqN  >  tempReg . seqNum)  { 
tempReg. seqNum  =  seqN; 

src . listenerAICGEvents (tempReg. any Ob j ) ; 

}  else  { 

//  old  events  ignored 
return; 

} 


}//  end  of  notifyHandler 
}//  end  of  class 


Figure  17,  Event  Handler 
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3 .  The  Callback  Template 

The  callback  template  is  a  simple  interface  class  with 
an  abstract  method  listenerAICGEvents .  Its  main  function  is 
to  allow  the  AICG  model  to  invoke  the  application  program 
when  certain  events  of  interest  are  "fired".  As  explained 
in  section  V.E,  the  template  need  to  be  implemented  by  the 
application  that  wishes  to  have  notification.  The  interface 
abstract  method  need  to  be  override  by  the  application  for 
the  callback  to  work. 


public  interface  notifyAICG 

//  abstract  method,  to  be  override  by  the  application 
//  with  the  codes  that  are  to  execute  when  the  event  fired 
public  abstract  void  listenerAICGEvents (Ob ject  ob j ) ; 

} 

Figure  18,  notifyAICG  interface 

D.  THE  TRANSACTION  MODULES 

The  transaction  modules  consist  of  transaction 
interface  (transactionAICG)  and  the  transaction  factory 
(transactionManagerAICG) . 

The  transaction  interface  class  comprise  of  a  group  of 
static  methods  that  are  used  for  obtaining  reference  to  the 
transaction  manager  server  anywhere  on  the  network.  It  uses 


53 


the  Java  RMI  registry  or  the  look-up  server  to  locate  the 
transaction  server. 

The  transaction  factory  uses  the  transaction  interface 
to  obtain  the  reference  to  the  server,  which  is  then  used  to 
create  the  default  transaction  or  user-defined  transaction. 
In  short,  the  transaction  factory  performs  the  following: 

1.  Invoke  the  transaction  interface  to  obtain  a 
transaction  manager. 

2 .  Create  default  transaction  with  lease  time  of  5 
seconds . 

3.  Create  transactions  with  user  define  lease  time. 

E.  THE  EXCEPTION  MODULE 

The  exception  module  defines  all  the  exception  codes 
that  are  returned  to  the  application  when  certain  unexpected 
conditions  occur  in  the  AICG  model.  The  exception  include: 

•  "NotDef inedExcept ionCode " ;  unknown  error  occur. 

•  " SystemExcept ionCode " ;  system  level  exceptions, 
such  disk  failure,  network  failure. 

•  "ObjectNotFoundException" ;  the  space  does  not 
contain  the  object. 

•  " Transact ionExcept ion " ;  transaction  server  not 
found,  transaction  expire  before  commit. 
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"LeaseExpireException" ;  object  lease  has  expired. 
"CommunicationException" ;  space  communication 

errors . 

"UnusableObjectException" ;  object  corrupted. 
"ObjectExistException" ;  there  another  object  with 
the  same  key  in  the  space. 

"NotificationException" ;  events  notification 

errors . 
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VII.  CONCLUSIONS  AND  RECOMMENDATION 

A.  CONCLUSIONS 

This  thesis  demonstrates  the  ease  of  sharing 
distributed  objects  and  automates  the  generation  of  generic 
interface  wrappers  directly  from  the  Prototype  System 
Description  Languages.  However,  the  design  has  a  performance 
price  penalty.  Every  read  operation  requires  the  interface 
to  synchronize  the  local  object  with  the  distributed  object 
before  the  value  is  returned.  Every  write  operation  requires 
two  Space  operations.  Adding  the  overhead  for  transactions, 
event  monitoring  and  control,  reading  operations  are  in  the 
range  of  a  hundred  milliseconds  and  writing  is  in  the  range 
of  a  few  hundred  of  milliseconds.  The  high  overhead  lies 
within  the  Java  Virtual  Machine  (JVM) ,  the  JavaSpace  Model 
and  the  network  latency.  Current  versions  of  JVM  and 
JavaSpace  are  in  a  premature  state  in  terms  of  performance . 
Even  so,  the  performances  are  still  suitable  for  most 
applications  that  are  not  time  critical.  Similar 
implementations  of  distributed  systems  with  the  above 
features  of  AICG  interface  in  CORBA  and  Java  would  not 
perform  any  better. 

Performance  is  not  the  main  concern  regarding  whether 
the  AICG  interface  model  is  suitable  for  developing 
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interoperability  between  real-time  applications,  but 
predictability  of  the  time  and  space  of  the  operations  are. 
Currently,  the  Java  language  lacks  some  important  real-time 
programming  features  such  as: 

1.  Language  features  for  capturing  common  idioms  for 
periodic  activity  and  asynchronous  event  handling. 

2.  Predictability  of  time  and  space.  The  language 
must  enable  prediction  of  the  worst-case  execution 
time  for  language  constructs,  to  avoid  "priority 
inversion"  and  it  should  not  run  out  of  storage  or 
fragment . 

In  the  near  future,  if  the  JVM  and  the  Java  language 
embrace  the  Real-Time  standards  currently  in  final  draft,  it 
should  be  able  to  bridge  the  gap  regarding  requirements  for 
real-time  systems. 

B .  RECOMMENDATIONS 

The  AICG  model  is  now  still  in  the  premature  stages  to 
be  a  useful  developer  tool .  More  features  and  developments 
are  needed  before  the  model  becomes  indispensable  for 
developing  distributed  applications.  The  following  sections 
describe  some  of  the  features  that  would  enhance  the 
usefulness  of  the  AICG  model. 
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1.  Graphical  User  Interface  (GUI) 

A  user-friendly  Graphical  Interface  would  allow  users 
to  develop  applications  using  graphical  objects  to  represent 
the  interfaces  and  the  distributed  objects.  The  graphical 
editor  would  allow  the  developer  to  include  operators,  input 
and  output  similar  to  those  of  the  CAPS  system.  An  expert 
system  would  then  provide  the  capability  to  generate  the 
PSDL  specifications  for  the  graphical  objects.  This  should 
speed  up  developments  that  use  the  AICG  model. 

2 .  Integration  With  The  CAPS  System 

AICG  model's  primary  objective  is  to  allow  developer  to 
improve  their  productivity  in  developing  reliable 
distributed  systems  by  simplifying  the  interoperability 
between  them. 

The  current  version  of  CAPS,  on  the  other  hand,  allows 
developers  to  design  and  build  reliable  end- systems. 
Integration  of  the  AICG  model  with  CAPS  would  complement 
each  other,  resulting  in  a  total  solution  for  developing 
truly  distributed  systems. 
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APPENDIX  A.  PSDL  GRAMMAR 


1 .  psdl  =  { component } 

2 .  component  =  data_type 

|  operator 

3.  data_type  =  "type"  id  type_spec  type_impl 

4.  type_spec  =  "specification"  ["generic"  type_decl] 

[type_decl] 

{"operator"  id  operator_spec} 

[functionality]  "end" 

5.  operator  =  "operator"  id  operator_spec  operator_impl 

6.  operator_spec  =  "specification"  {interface} 

[functionality]  "end" 

7.  interface  =  attribute  [reqmts_trace] 

8.  attribute  =  "generic"  type_decl 

|  "input"  type_decl 
j  "output"  type_decl 

j  "states"  type_decl  "initially" 

initial_expression_list 

|  "exceptions"  id_list 
j  "maximum  execution  time"  time 

9.  type_decl  =  id_list  ":"  type_name  {","  id_list  " : " 

type_name } 

10.  type_name  =  id  |  id  " ["  type_decl  "3" 

11.  id_list  =  id  {","  id} 

12.  reqmts_trace  =  "by  requirements"  id_list 

13.  functionality  =  [keywords]  [informal_desc]  [formal_desc] 

14.  keywords  =  "keywords"  id_list 

15.  informal_desc  =  "description"  "{"  text  "}" 

16.  formal  de sc  =  "axioms"  "{"  text  "}" 
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17.  type_impl  =  "implementation  ada"  id  "end" 

|  "implementation"  type_name  {"operator"  id 
operat or_impl }  " end " 

18.  operat or_impl  =  "implementation  ada"  id  "end" 

|  "implementation"  psdl_impl  "end" 

19.  psdl_impl  =  data_flow_diagram  [streams]  [timers] 
[control_constraints] 

[informal_desc] 

20.  da t a_f 1 ow_di agr am  =  "graph"  {vertex}  {edge} 

21.  vertex  =  "vertex"  op_id  [":"  time] 

--  time  is  the  maximum  execution  time 


22.  edge  =  "edge"  id  [":"  time]  op_id  op_id 

--  time  is  the  latency 


23.  op_id  =  id  ["("  [id_list]  "|"  [id_list]  ")"] 


24.  streams  =  "data  stream"  type_decl 

25.  timers  =  "timer"  id_list 

26.  control_constraints  =  "control  constraints"  constraint 
{constraint } 

27.  constraint  =  "operator"  op_id 

["triggered"  [trigger]  ["if"  expression] 

[reqmts_trace] ] 

["period"  time  [regmts_trace]  ] 

["finish  within"  time  [reqmts_trace] ] 

["minimum  calling  period"  time  [reqmts_trace] ] 
["maximum  response  time"  time  [regmts_trace] ] 

{ constraint_opt ions } 


28.  constraint_options  =  "output"  id_list  "if" 
[reqmts_trace] 

I  "exception"  id  ["if" 

[reqmt s_trace] 

|  timer_op  id  ["if" 

[reqmt s_t race] 


29.  trigger  =  "by  all"  id_list 
|  "by  some"  id_list 


expression 

expression] 

expression] 
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30.  timer_op  =  "reset  timer" 

|  "start  timer" 
j  "stop  timer" 

31.  initial_expression_list  =  initial_expression  {"," 
initial_expression} 

32.  initial_expression  =  "true"  |  "false" 

|  integer__literal  |  real_literal 
|  string_literal  |  id 
I  type_name  " . "  id 

initial_expression_list  ")"] 

"("  initial_expression  ")  " 
initial_expression 

initial_expression 

|  unary_op  initial_expression 

33.  binary_op  =  "and"  |  "or"  |  "xor" 

|  n  <  ii  |  ii  >n  |  if  =  ii  |  n>==n  |  »<=,! 
j  II  +  II  |  II  _  H  |  II  &.H  |  II  *  II  |  II  j  II 

II  *  *  II 

34.  unary_op  =  "not"  |  "abs"  |  |  "+" 

35.  time  =  integer_literal  unit 

36.  unit  =  "microsec"  |  "ms" 

|  "sec"  |  "min"  |  "hours" 

37.  express ion_li st  =  expression  expression} 

38.  expression  =  "true"  |  "false" 

integer_literal 

time 

real_literal 

string_literal 

id 

type_name  id  ["("  initial_expression_list 

")"] 

|  "("  expression  ")" 

j  initial_expression  binary_op  initial_expression 
I  unary_op  initial_expression 

39.  id  =  letter  {alphanumeric} 

40.  real_literal  =  integer  "."  integer 


I  "/=" 

|  "mod"  |  "rem"  | 


["  (" 
binary_op 
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41.  integer_literal  =  digit  {digit} 

42.  string_literal  =  """  {char}  """ 

43.  char  =  any  printable  character  except  "}" 

44 .  digit  =  "0  . .  9" 

45.  letter  =  "a  ..  z"  |  "A  . .  Z"  |  "  " 

46.  alpha_numberic  =  letter  |  digit 

47.  text  =  {char} 


EXTENSION  TO  PSDL  FOR  AICG  MODEL 


Changes : 


17.  type_impl  =  "implementation  ada"  id  "end" 

|  "implementation"  type_name  {"operator" 
operator_impl }  "end" 

I  "implemetation  space"  <space_impl> 


18  <operator_impl>  ::=  implementation  <id>  <id>  end 

|  implementation  <psdl_impl>  end 

|  implementation  <class_impl>  end 


Additional : 

51.  <space_impl>  ::=  space  {<property>}  end 


id 
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APPENDIX  B.  EXAMPLES  OF  GENERATED  INTERFACE  WRAPPER 


ENTRYAICG . JAVA 

// - 

//  Filename  :  entryAICG . j ava 

//  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 

//  Date  :  01/07/00 

// - - - 

/  *  * 

*  Class  autoCodeException 

* 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

* 

*  Description 

*  Basic  components  of  the  java  space  object.  All  distributed  objects 

*  implements  the  entryAICG. 

*/ 

package  interfaceAICG; 

import  net. j ini. core. entry. Entry; 

public  abstract  class  entryAICG  implements  Entry 

{ 

//  main  identif cation  number 
public  Integer  entrylD; 

//  require  by  JavaSpace  default  constructor 
public  entryAICG (  )  { 

} 

public  entryAICG (int  id) { 
entry ID  =  new  Integer ( id) ; 

} 

//  return  the  object  stored  in  the  entry 
public  abstract  Object  getObject(  ); 


} 


TRACK. JAVA 


// - 

//  Filename  :  track . j ava 
//  Version  :  0.1 
//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 
//  Date  :  01/07/00 

// - 

/** 

* 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

* 

*  Description 

*  Distributed  Object,  each  object  is  distinguish  by  a  unique 

*  tracknumber. 

*/ 

package  interf aceAICG; 

public  class  track  implements  j ava . io . Serializable 


private  Integer  tracknumber; 
private  String  callsign; 
private  position_type  position; 

public  track (  int  x)  { 

tracknumber  =  new  Integer (x) ; 
callsign  =new  String (); 
position  =  new  position_type (0 , 0) ; 


public  int  getID(  )  { 

return  tracknumber . intValue ( ) ; 


} 

public  void  setCallsign(  String  si)  { 
callsign  =  new  String (si); 


} 

public  String  getCallsign(  )  { 

return  callsign; 


} 

public  void  setPosition{  position_type  post)  { 
position. x  =  post.x; 
position. y  =  post.y; 


} 

public  position_type  getPosition(  )  { 

return  position; 
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} 


//  automatically  generated  do  not  delete!! 
public  synchronized  Integer  getaicglDK) 

{ 

return  tracknumber ; 

} 


} 


TRACKENTRY . JAVA 

// - 

//  Filename  :  trackEntry . java 

//  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 

//  Date  :  01/07/00 

// - - - 

/** 

★ 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

* 

*  Description 

★ 

*/ 

package  interf aceAICG; 

public  class  trackEntry  extends  entryAICG 

{ 

public  Integer  aicgIDl ; 


public  track  data; 
public  trackEntry () { } 

public  trackEntry (int  aid,  Integer  aicgIDl,  track  inData) { 
super (aid) ; 
data  =  inData; 
this.aicgIDl  =  aicgIDl; 


} 

public  Object  getObject(){ 
return  data; 

} 


} 
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TRACKEXT. JAVA 


//____ - 

//  Filename  :  trackExt . java 

//  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 

//  Date  :  01/07/00 

// - 

J  *  * 

* 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

* 

*  Description 

* 

*/ 

package  interf aceAICG; 

import  net . j ini . core . lease . Lease ; 
import  net. j ini. space. JavaSpace; 
import  net . j ini . core . event ; 

public  class  trackExt  implements  j ava . io . Serializable 
protected  JavaSpace  space; 

protected  static  transactionManagerAICG  trnMgr; 
protected  eventAICGID  notifylD; 
protected  eventAICGHandler  evHandler; 
protected  boolean  handlerEvent; 
protected  trackEntry  distObj ; 

//  user  ids 

protected  Integer  aicgIDl; 


/*★ 

*  Constructor,  with  notification  disable 
*/ 

public  trackExt ( ) 

throws  exceptionAICG  { 
evHandler  =  null; 
handlerEvent  =  false; 

space  =  spaceAICG . getSpace (globalAICG . AICGSPACENAME) 
//  set  the  ids  to  null 
aicgIDl  -  null; 


} 


//  if  there  are  n  ids  there  will  be  n  setID 
public  synchronized  void  setaicgIDl (  Integer  inID) 

aicgIDl  =  inID; 
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} 


//  n  set  of  get  ids 

public  synchronized  Integer  getaicgIDl() 

{ 

return  aicgIDl; 

} 


//always  present  xxxStratTxn 

public  static  void  trackStartTxn () throws  except ionAICG{ 
trnMgr  =  new  transactionManagerAICG ( ) ; 

} 


} 


TRACKEXTCLIENT . JAVA 

// - 

//  Filename  :  trackExtClient . j ava 

//  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 

//  Date  :  01/07/00 

// - 

/** 

* 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

* 

*  Description 

* 

*/ 

package  interf aceAICG; 

import  net . j ini . core . lease . Lease ; 
import  net. j ini. space. JavaSpace; 

import  net . j ini . core . transaction . * ; 
import  net . j ini . core . transaction . server . * ; 

public  class  trackExtClient  extends  trackExt 

{ 

//  client  constructor 

public  trackExtClient (  Integer  aicgIDl)  throws  except ionAICG{ 
super ( ) ; 

int  retry  *  globalAICG . AICGDEFAULTRETRY; 
boolean  trxSucc  =false; 

Integer  tempaicgIDl  =  aicgIDl  ; 
while  (retry  1=0) { 
try{ 

//  create  atemplate  to  seach  for  the  object 
trackEntry  template  =  new 

trackEntry (globalAICG. AICGIDENTIFIER  ,  tempaicgIDl,  null) ; 
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distObj  =  (trackEntry)  space . read (template , null , 
globalAICG .  AICGDEFAULTWAITTIME)  ; 
track  ddata  =  (track)  distObj .getObject () ; 

setaicgIDl (ddata . getaicgIDl ( ) ) ; 
retry  =  0; 
trxSucc  =  true; 

} catch  (Exception  e) { 

System. err .println ( "retrying  to  find  object"); 
retry-- ; 

} 

}//  end  of  while 
if  (  ! trxSucc) { 

throw  new  except ionAICG (except ionAICG. Ob j ectNotFoundExcept ion) ; 

}  1 


//  event  notification  setting 

public  void  setEvent (event AICGHandler  inEv)  throws  exceptionAICG 
evHandler  =  inEv; 

notifylD  =  evHandler . trackAddNot if y (this); 


//  readonly  methods 

public  int  getID(  )  throws  exceptionAICG  { 
trackEntry  msgTemplate  =  new  trackEntry (globalAICG .  AICGIDENTIFIER, 
aicgIDl,  null) ; 

try  { 

distObj  =  (trackEntry) 

space . read (msgTemplate ,  null , 
globalAICG .AICGDEFAULTWAITTIME) ; 
if  (distObj==null) { 

//  object  nolonger  exist 
throw  new 

exceptionAICG (exceptionAICG . Ob j  ectNotFoundException) ; 

return  distObj . data. get ID () ; 

}catch  (exceptionAICG  ex) { 

throw  new  exceptionAICG (except ionAICG. Ob j ectNotFoundException) ; 
} catch  (Exception  e)  { 

throw  new  exceptionAICG (exceptionAICG. SystemExceptionCode) ; 

}  1 

public  String  getCallsign(  )  throws  exceptionAICG  { 
trackEntry  msgTemplate  =  new  trackEntry (globalAICG .AICGIDENTIFIER, 
aicgIDl,  null) ; 

try{ 

distObj  =  (trackEntry) 

space . read (msgTemplate ,  null , 
globalAICG. AICGDEFAULTWAITTIME) ; 
if  (distObj ==null) { 

//  object  nolonger  exist 
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throw  new 

except ionAICG  (except ionAICG . Ob j ectNotFoundException)  ; 

} 

return  distObj .data .getCallsign () ; 

}catch  (exce ptionAICG  ex)  { 

throw  new  except ionAICG (except ionAICG. Ob j ectNotFoundExcept ion) ; 
} catch  (Exception  e)  { 

throw  new  exceptional CG (except ionAICG .SystemExceptionCode); 


public  position_type  getPosition(  )  throws  exceptionAICG  { 
trackEntry  msgTemplate  =  new  trackEntry  (globalAICG . AICGIDENTIFIER, 
aicgIDl,  null) ; 

try{ 

distObj  =  (trackEntry) 

space . read (msgTemplate,  null, 
globalAICG .  AICGDEFAULTWAITTIME)  ; 
if  (distObj==null)  { 

//  object  nolonger  exist 
throw  new 

exceptionAICG  (except  ionAICG.  Ob  j  ectNotFoundExcept  ion)  ; 

} 

return  distObj . data .getPosition ( ) ; 

} catch  (exceptionAICG  ex)  { 

throw  new  exceptionAICG (exceptionAICG. Ob j ectNotFoundException) ; 
}catch  (Exception  e)  { 

throw  new  exceptionAICG (exceptionAICG . SystemExceptionCode) ; 


TRACKEXTSERVER . JAVA 

// - 

//  Filename  :  trackExtServer . j ava 

//  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 

//  Date  :  01/07/00 

// - 

/** 

* 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

* 

*  Description 

* 

*/ 

package  interf aceAICG; 

import  net . j ini . core . lease . Lease ; 
import  net. j ini. space. JavaSpace; 
import  net . j ini . core . transaction . * ; 
import  net . j ini . core . transaction . server . * ; 
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public  class  trackExt Server  extends  trackExt 

{ 

//  constructor 

public  trackExtServer (  int  x)  throws  exceptionAICG{ 
super  (); 

//  create  the  template 
Transaction  trn  =  null; 
try  { 

trn  =  trnMgr . getDef aultTransaction () ; 
try{ 

track  ddata  =  new  track (x); 

setaicgIDl (ddata .getaicgIDl  () ) ; 
trackEntry  template  =  new 

trackEnt ry (globalAICG . AICGIDENTIFIER ,  aicgIDl,  null); 

//check  if  the  distobj  exit 

if  (space. read (template,  trn,  JavaSpace .N0_WAIT)  ==  null) { 
distObj  =  new  trackEntry (globalAICG. AICGIDENTIFIER, 
aicgIDl,  ddata) ; 

space. write (distobj ,  trn,  globalAICG. AICGLEASETIME) ; 
trn. commit () ; 

}else{ 

//  throws  an  exception 
trn. abort () ; 
throw  new 

except ionAICG ( except ionAICG. Ob j ectExistExcept ion) ; 

}catch  (exceptionAICG  e) { 
trn. abort  ()  ; 

throw  new  exceptionAICG (e . getErrorCode ()) ; 

} catch  (Exception  e)  { 
trn.  abort  {)  ; 
e.printStackTrace () ; 

throw  new  exceptionAICG  (exceptionAICG .  SystemExceptionCode)  ; 

}catch  (exceptionAICG  e)  { 

throw  new  exceptionAICG (e .getErrorCode ()) ; 

} catch  (Exception  e)  { 

throw  new  exceptionAICG (exceptionAICG . SystemExceptionCode) ; 

} 


//  event  notification  setting 
public  void  setEvent (eventAICGHandler  inEv) 

{ 

evHandler  =  inEv; 

} 

//  others  methods 

public  int  getID(  )  throws  exceptionAICG  { 
trackEntry  msgTemplate  =  new  trackEntry (globalAICG. AICGIDENTIFIER, 
aicgIDl,  null) ; 

try{ 

distobj  =  (trackEntry) 
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space . read (msgTemplate,  null, 
globalAICG . AICGDEFAULTWAITTIME) ; 
if  (distObj —null) { 

//  object  nolonger  exist 
throw  new 

except ionAICG ( except ionAICG . Ob j  ectNotFoundExcept ion) ; 

} 

return  distObj . data . getID ( )  ; 

} catch  (exceptionAICG  ex) { 

throw  new  exceptionAICG (exceptionAICG. Ob j ectNotFoundException) ; 
}catch  (Exception  e)  { 

throw  new  exceptionAICG (exceptionAICG. SystemExceptionCode) ; 

} 

} 

public  String  getCallsign(  )  throws  exceptionAICG  { 
trackEntry  msgTemplate  =  new  trackEntry (globalAICG. AICGIDENTIFIER, 
aicgIDl,  null) ; 

try{ 

distObj  =  (trackEntry) 

space . read (msgTemplate,  null, 
globalAICG. AICGDEFAULTWAITTIME) ; 
if  (distObj ==null) { 

//  object  nolonger  exist 
throw  new 

exceptionAICG (exceptionAICG. Ob j  ectNotFoundException) ; 

} 

return  distObj . data . getCallsign () ; 

} catch  (exceptionAICG  ex) { 

throw  new  exceptionAICG (exceptionAICG. Obj ectNotFoundException)  ; 
} catch  (Exception  e)  { 

throw  new  exceptionAICG (exceptionAICG . SystemExceptionCode) ; 

} 

} 

public  position_type  getPosition(  )  throws  exceptionAICG  { 
trackEntry  msgTemplate  =  new  trackEntry (globalAICG .AICGIDENTIFIER, 
aicgIDl,  null) ; 

try{ 

distObj  =  (trackEntry) 

space . read (msgTemplate ,  null , 
globalAICG. AICGDEFAULTWAITTIME)  ; 
if  (distObj ==null) { 

//  object  nolonger  exist 
throw  new 

exceptionAICG (exceptionAICG. Obj ectNotFoundException) ; 

} 

return  distObj .data.getPosition () ; 

} catch  (exceptionAICG  ex) { 

throw  new  exceptionAICG (exceptionAICG . Obj ectNotFoundException) ; 
} catch  (Exception  e)  { 

throw  new  exceptionAICG (exceptionAICG . SystemExceptionCode) ; 

} 
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public  void  setCallsign(  String  si)  throws  exceptionAICG  { 
int  retry  =  globalAICG . AICGDEFAULTRETRY ; 
boolean  trxSucc  =false; 
trackEntry  msgTemplate  = 

new  trackEntry (globalAICG . AICGIDENTIFIER ,  aicgIDl,  null); 
Transaction  trn  =  null; 

while(retry  !=0) { 
try  { 

trn  =  trnMgr . createTransact ion (globalAICG. USERTXNLEASE) ; 
try{ 

distObj  =  (trackEntry) 

space . take (msgTemplate ,  trn.  Long . MAX_VALUE ) ; 

//  called  the  actual  method 
distObj .data.setCallsign(si) ; 

space .write (distObj , trn, globalAICG. AICGLEASETIME) ; 
trn. commit () ; 
retry  =  0; 
trxSucc  =  true; 

}catch  (Exception  e) { 
trn. abort () ; 
retry  - - ; 

System. err. println ( "Exception  level  1:  retrying"); 

} catch  (Exception  e)  { 
retry--; 

System. err. print In ("Exception  level  2:  retrying"); 

}//  end  of  while 
if  ( ! trxSucc) { 

throw  new  exceptionAICG (exceptionAICG. SystemExceptionCode) ; 

}  } 

public  void  setPosition(  posit ion_type  post)  throws  exceptionAICG 

int  retry  =  globalAICG. AICGDEFAULTRETRY ; 
boolean  trxSucc  =false; 
trackEntry  msgTemplate  = 

new  trackEntry (globalAICG. AICGIDENTIFIER,  aicgIDl,  null) ; 
Transaction  trn  =  null; 

while(retry  1=0)  { 
try  { 

trn  =  trnMgr. createTransaction (globalAICG. USERTXNLEASE ) ; 
try{ 

distObj  =  (trackEntry) 

space. take (msgTemplate,  trn.  Long . MAX_VALUE ) ; 

//  called  the  actual  method 
distObj . data. setPosition (post) ; 

space. write (distObj , trn, globalAICG. AICGLEASETIME) ; 
trn. commit () ; 
retry  =  0; 
trxSucc  =  true; 

} catch  (Exception  e) { 
trn. abort () ; 
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retry 

System. err .print In ("Except ion  level  Is  retrying"); 

}catch  (Exception  e)  { 
retry- - ; 

System. err. println ("Exception  level  2:  retrying"); 

} 

}//  end  of  while 
if  (!trxSucc){ 

throw  new  except ionAICG (except ionAICG. SystemExceptionCode) ; 


} 


NOTIFYAICG . JAVA 

// - - - 

//  Filename  :  notifyAICG . j ava 

//  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 

//  Date  :  01/07/00 

// - - 

/** 

*  Class  autoCodeException 

* 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

* 

*  Description 

*  interface  class,  user  application  must  implements  notifyAICG 

*  for  event  callback  to  work. 

*/ 

package  interf aceAICG; 

public  interface  notifyAICG 

{ 

public  abstract  void  listenerAICGEvents (Object  ob j ) ; 

} 


EVENTAICGID . JAVA 

// - - - 

//  Filename  :  eventAICGID . java 

/ /  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Gerenated:  auto 

//  Date  :  01/07/00 
// - 
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/** 

* 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

* 

*  Description 

*  event  class,  used  to  categorise  the  type  of  events 
*/ 

package  interfaceAICG; 
import  java. io. Serializable; 

public  class  eventAICGID  implements  Serializable 

private  long  id; 
private  Object  src; 

public  eventAICGID (long  id.  Object  src) { 
this.id=id; 
this . src=src; 

} 


public  boolean  equals (Object  ob j ) { 
if  (obj  ==  null) { 
return  false; 

} 

if  (obj .getClass ()  !=  this .getClass ( ) )  { 

return  false; 

} 

eventAICGID  tempID  =  (eventAICGID)  ob  j  ; 
if  ((id  ==  tempID. id)  &&  (src . equals (tempID. src) )) { 
return  true ; 

}else  { 

return  false; 


public  String  toString(){ 

return  (src . toString ( )  +  Long.toString(id) )  ; 

} 


EVENT  AX  CGHANDLER .  JAVA 

II  — - 

//  Filename  :  eventAICGHandler. java 

//  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 

//  Date  :  01/07/00 
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// 


/** 

* 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0 . 1 

* 

*  Description 

*  Main  event  handler  of  the  generated  codes . 

*/ 

package  interfaceAICG; 

import  j ava . io . Serializable ; 
import  j  ava . ut il . Hashtable ; 

import  java.rmi .RemoteException; 

import  j  ava . rmi . server . * ; 

import  net. j ini. core. event.*; 

import  net . j ini . core . lease . Lease ; 

import  net . j ini . core . transaction . * ; 

import  net . j ini . core . transaction . server . * ; 

import  net . j ini . space . JavaSpace ; 

/  ** 

*  eventAICGHAndler,  handles  all  the  external  notification  from  the 
space 

*/ 

public  class  eventAICGHandler  implements  RemoteEventListener, 
Serializable 
{ 

private  notifyAICG  src; 
private  Hashtable  storage; 
private  JavaSpace  space; 

public  class  registerAICG  implements  Serializable { 
public  EventRegistration  reg; 
public  long  seqNum; 
public  Object  anyOb j ; 

public  registerAICG (EventRegistration  inReg,  long  inSeqNum, 

Ob j  ect  obj ) { 

s  e  qNum  =  inSeqNum ; 
reg  =  inReg; 
anyOb j  =  obj ; 

} 

} 

public  eventAICGHandler (notifyAICG  inSrc)  throws  exceptionAICG{ 
src  =  inSrc; 

space  =  spaceAICG .  getSpace  (globalAICG .  AICGSPACENAME)  ; 
storage  =  new  Hashtable (); 

//  export  the  object 
try{ 

UnicastRemoteObject . exportObj  ect (this) ; 

} catch  (RemoteException  e) { 

System. err. println ( "error  in  exporting  object"); 
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e.printStackTrace ()  ; 

throw  new  exceptionAICG (exceptionAICG.Notif icationException) ; 


} 

public  void  notify (RemoteEvent  event)  { 

notifyHandler  nh  =  new  not if yHandler (event) ; 
new  Thread (nh) .start () ; 

/** 

*  trackAddNotify,  add  an  object  to  the  list  of  events  to  be 
monitor 

*/ 

public  eventAICGID  trackAddNotify (trackExt  indata)  throws 
exceptionAICG { 

EventRegistration  reg; 
long  seqNum; 
registerAICG  tempReg; 
eventAICGID  keylD; 

try{ 

trackEntry  template  =  new  trackEntry (globalAICG . AICGIDENTIFIER 

, indata . getaicgIDl ( ) , 

null)  ; 

reg  =  space. notify (template,  null,  this, 
globalAICG- AICGLEASETIME, null) ; 

seqNum  =  reg.getSequenceNumber () ; 

tempReg  =  new  registerAICG (reg, seqNum, indata) ; 

key ID  =  new  eventAICGID (reg. getID (), reg .getSource ()) ; 

String  key  =  new  String (key ID. toString ()) ; 
storage. put (key, tempReg) ; 

return  keylD; 

} catch  (Exception  e) { 

System. err.println( "Notification  Exception") ; 

throw  new  exceptionAICG (exceptionAICG.Notif icationException); 


} 

j  *  * 

*  trackAddNotify,  add  an  object  to  the  list  of  events  to  be 
monitor  with 

*  transaction  control 
*/ 


public  eventAICGID  trackAddNotify (trackExt  indata.  Transaction  trn 

throws  exceptionAICG{ 

EventRegistration  reg; 
long  seqNum; 
registerAICG  tempReg; 
eventAICGID  keylD; 
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try{ 

trackEntry  template  =  new  trackEntry (globalAICG . AICGIDENTIFIER 

,  indata . getaicgIDl  ( ) , 


null)  ; 

reg  =  space .notify (template ,  trn,  this.  Leas e. FOREVER, null ) ; 

seqNum  =  reg . getSequenceNumber () ; 

tempReg  =  new  registerAICG (reg, seqNum,  indata); 

keylD  =  new  eventAICGID (  reg.getIDO,  reg.getSource ( ) ) ; 

storage. put (key ID, tempReg) ; 

// 

System. out .print In ("Key:  "  +  keylD) ; 
return  keylD; 

} catch  (Exception  e)  { 

throw  new  except ionAICG (except ionAICG. Not if icationExcept ion) ; 

} 


} 

j  *  * 

*  trackDeleteNotify,  remove  an  object  from  the  list  of  events  to 
be  monitor 
*/ 

public  void  trackDeleteNotify (eventAICGID  id)  throws  except ionAICG { 
registerAICG  tempReg; 
try  { 

tempReg  =  (registerAICG)  storage . remove (id) ; 

Lease  lease  =  tempReg. reg. getLease () ; 
lease. cancel () ; 

}catch  (Exception  e)  { 

throw  new  exceptionAICG (except ionAICG .Notif icationException) ; 


public  class  notifyHandler  implements  Runnable { 
private  RemoteEvent  event; 

public  notifyHandler (RemoteEvent  event).  { 
this. event  =  event; 

} 

public  void  run()  { 

Object  source  =  event . getSource () ; 

long  id  =  event. get ID () ; 

long  seqN  =  event . getSequenceNumber () ; 

eventAICGID  keyID=  new  eventAICGID (id, source) ; 

registerAICG  tempReg; 

System. out .println ( "Key :  "  +  keylD) ; 

String  key  =  new  String (keylD . toString ()) ; 
if  ((tempReg  =  (registerAICG)  storage .get (key) )  !=null) 

{ 

if  (seqN  >  tempReg . seqNum)  { 
tempReg . seqNum  =  seqN; 

src.listenerAICGEvents (tempReg. anyObj ) ; 

}  else  { 

//  old  events  ignored 
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return; 


}//  end  of  notifyHandler 
}//  end  of  class 


TRANSACTIONAICG .  JAVA 

- ----- 

//  Filename  :  transactionAICG . j ava 

//  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 

//  Date  :  01/07/00 

// - 

/** 

* 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

* 

*  Description 

*  static  methods  for  supporting  the  transaction. 

*/ 

package  interf aceAICG; 
import  j  ava . rmi . * ; 

import  net . j ini . core . transaction . server . TransactionManager ; 

import  com . sun . j ini . mahout . Locator ; 
import  com . sun . j ini . outrigger . Finder ; 

public  class  transactionAICG 

{ 

public  static  TransactionManager  getManager (String  name)  { 
Locator  locator  =  null; 

Finder  finder  =  null; 

if  (System.getSecurityManager ()  ==  null)  { 
System. setSecurityManager ( 

new  RMISecurityManager  () ) ; 


if  (System. get Property ( "com . sun . j ini . use . registry" )  !  = 

null)  { 

locator  =  new  com.  sun . j ini .mahout . Regis tryLocator () ; 
finder  =  new  com. sun . j ini . outrigger .Regis tryFinder () ; 
}  else  { 

System. out .print In ("lookup  is  used"); 
locator  =  new 

com. sun. j ini . outrigger .DiscoveryLocator  () ; 

finder  =  new  com. sun. j ini . outrigger .LookupFinderO; 
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return  (TransactionManager) finder . find (locator,  name) ; 


} 

public  static  TransactionManager  getManagerO  { 
return 

getManager  (com .  sun .  j  ini . mahalo .  TxnManagerlmpl . DEFAULT_NAME)  ; 


TRANSACT  INMANAGERAI CG .  JAVA 

// - 

//  Filename  :  transactionManagerAICG . j ava 

//  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 

//  Date  :  01/07/00 

// - 

/** 

*  Class  autoCodeException 

* 

*  @author  Cheng  Heng  Ngom 

*  (Aversion  0.1 

* 

*  Description 

*  Main  transaction  handler. 

*/ 


package  int erf aceAICG ; 

import  net . j ini . core . lease . Lease ; 
import  net . j ini . core . transaction . * ; 
import  net . j ini . core . transaction . server . * ; 

public  class  transactionManagerAICG 

{ 

private  TransactionManager  TxnMgr; 

public  transactionManagerAICG ()  throws  exceptionAICG  { 
//  get  the  reference  to  transaction  Manager 
TxnMgr  = 

transactionAI CG. getManager () ; 


} 

public  TransactionManager  getTransactionManager () { 
return  TxnMgr ; 

} 

public  Transaction  getDefaultTransactionO  throws  exceptionAICG 

{ 

Transaction  defaultTxn; 

Transaction. Created  trc  =  null; 
try  { 
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trc  =  Transact ionFactory. create 

(TxnMgr ,  globalAICG .  AICGDEFAULTTXNLEASE  )  ; 
defaultTxn  =  trc . transaction; 

}  catch  (Exception  e)  { 

System. err .print In ( 

"Could  not  create  transaction  " )  ; 
throw  new 

exceptionAICG (except ionAICG . Transact ionException) ; 
return  defaultTxn; 

} 

public  Transaction  createTransaction (long  leaseTime) throws 
exceptionAICG 

{ 

Transaction  Txn; 

Transaction. Created  trc  =  null; 
try  { 

trc  =  TransactionFactory. create (TxnMgr, leaseTime) ; 
Txn  =  trc . transaction; 
return  Txn; 

}  catch  (Exception  e)  { 

System . err . print In ( 

"Could  not  create  transaction  "); 
throw  new 

exceptionAICG  (exceptionAICG .  Transact  ionException)  ; 


} 


EXCEPTIONAICG . JAVA 

// - - - 

//  Filename  :  exceptionAICG. java 
//  Version  :  0.1 
//  Compiler  :  jdk  1.2  or  J++ 

/ /  Generated  :  auto 
//  Date  :  01/07/00 

// - 

J  *  * 

* 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0 . 1 

* 

*  Description 

*  Main  Exception  class  of  the  automatic  code  generator.  Each  form  of 

*  excpetion  is  given  an  error  code  instead  of  having  a  new  excetion 

*  class  define  for  it. 

*/ 

package  interf aceAICG; 

public  class  exceptionAICG  extends  Exception 
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/** 

*  NotDefinedExceptionCode,  given  to  any  exception  that 

*  does  not  have  an  error  code 
*/ 

public  static  final  int  NotDefinedExceptionCode  =  0; 

/** 

*  SystemExceptionCode 
*/ 

public  static  final  int  SystemExceptionCode  =  1; 


/** 

*  Object  not  found,  time  out  exception 
*/ 

public  static  final  int  ObjectNotFoundException  =  2; 

j  *  * 

* 

*/ 

public  static  final  int  TransactionException  =  3; 

/  ** 

* 

*/ 

public  static  final  int  LeaseExpireException  =4; 

J  *  * 

* 

*/ 

public  static  final  int  CommunicationException  =  5; 

/*★ 

* 

*/ 

public  static  final  int  UnusableObjectException  =6; 


J  *  * 

* 

*/ 

public  static  final  int  ObjectExistException  =  7; 

/** 

* 

*/ 

public  static  final  int  Notif icationException  =  8; 


public  static  final  String []  ExceptionMessage= 
{ "NotDefinedExceptionCode " , 

" SystemExceptionCode" , 

"ObjectNotFoundException" , 

"TransactionException" , 

"LeaseExpireException" , 
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"CommunicationException" , 
"UnusableObjectException” , 
"Obj ectExistException" , 
"Notif icationException" } ; 


/** 

*  errorCode  define  the  type  of  exception  that  occur 
*/ 

public  int  errorCode; 

J  *  * 

*  default  constructor,  no  argument. 

*/ 

public  exceptionAICGO  { 
super ( ) ; 

errorCode  =  NotDef inedExceptionCode; 


/** 

*  Constructor. 

*  @param  code:  int  value  of  the  error  code 
*/ 

public  except ionAICG (int  code) { 
super (ExceptionMessage [code] ) ; 
errorCode  =  code; 

} 

J  *  * 

*  getErrorCode,  return  the  erro  code  of  the  exception 

*  ©return  int,  error  code 
*/ 

public  int  getErrorCode () { 
return  errorCode; 

} 


} 


SPACEAI CG . JAVA 

// - 

//  Filename  :  spa ceAICG. java 

//  Version  :  0.1 

//  Compiler  :  jdk  1.2  or  J++ 

//  Generated:  auto 

//  Date  :  01/07/00 
// - - - 

/** 

*  Class  autoCodeException 
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*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

* 

*  Description 

*  static  methods  for  supporting  the  java  space. 
*/ 


package  interf aceAICG; 

import  j  ava . rmi . *  ; 

import  net .j ini. space. JavaSpace; 

import  com . sun . j ini . mahout . binder . Ref Holder ; 
import  com . sun . j ini . mahout . Locator  ; 
import  com . sun . j ini . outrigger . Finder ; 

public  class  spaceAICG  { 

public  static  JavaSpace  getSpace (String  name) throws  exceptionAICG 
try  { 

if  (System. getSecurityManager ()  ==  null)  { 

System. setSecurityManager ( 

new  RMISecurityManager () ) ; 

} 

if  (System . getProperty ( " com . sun . j ini . use . registry” ) 

==  null) 

{ 

Locator  locator  = 

new  com. sun. j ini . outrigger .DiscoveryLocator ( ) ; 
Finder  finder  = 

new  com . sun . j ini . outrigger . LookupFinder ( ) ; 
return  (JavaSpace) finder . find (locator,  name) ; 

}  else  { 

Ref Holder  rh  =  ( Ref Holder) Naming . lookup (name) ; 
return  (JavaSpace) rh. proxy () ; 

} 

}  catch  (Exception  e)  { 

System. err. println(e.getMessage  0 ) ; 

throw  new  exceptionAICG (exceptionAICG. SystemExceptionCode) ; 

} 

public  static  JavaSpace  getSpace () throws  exceptionAICG 

{ 

return  getSpace ( nDODSpacesn ) ; 


POSITION_TYPE  .JAVA 

package  modelv2; 

import  j ava . io . Serializable ; 
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public  class  position_type  implements  Serializable 

public  int  x; 
public  int  y; 

public  position_type (int  x,  int  y) 

this.x  =  x; 
this.y  =  y ; 

} 

public  String  toString(){ 

return  ( Integer. toString (x)  +  "  »  +Integer.toString (y) ) ; 

} 
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APPENDIX  C.  PSDL2 SPACE  CODE  LISTINGS 


AUTOMCODEEXCEPTION. JAVA 

// - 

//  Filename  :  automCodeExcept ion. java 
//  Version  :  1.0 
//  Compiler  :  jdk  1.2  or  J++ 

// - - 

package  psdl2 java. global; 

/** 

* 

*  ©author  Cheng  Heng  Ngom 

*  (Aversion  1 . 0 

* 

*  Description 

*  Main  Exception  class  of  the  automatic  code  generator.  Each  form  of 

*  excpetion  is  given  an  error  code  instead  of  having  a  new  excetion 

*  class  define  for  it. 

*/ 


public  class  automCodeGenException  extends  Exception 

{ 

/** 

*  NotDef inedExceptionCode,  given  to  any  exception  that 

*  does  not  have  an  error  code 
*/ 

public  static  final  int  NotDef inedExceptionCode  =  -1; 

/** 

*  SystemExceptionCode  0  to  9 
*/ 

public  static  final  int  SystemExceptionCode  =  1; 
j  *  * 

*  Paser  Exception  is  given  the  code  10  to  19 
*/ 

public  static  final  int  ParserExceptionCode  =  10; 

/** 

*  Wrong  Type  expected 
*/ 

public  static  final  int  ParserWrongTypeCode  =11; 

/  ** 

*  Syntax  Error,  eg,  missing  END 
*/ 

public  static  final  int  ParserSyntaxError  =  12; 

/** 

*  State  or  output  parameter  must  not  be  of  primitive  type 
*/ 
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public  static  final  int  ParserStateError  =  13; 
j  *  * 

*  EOF  detected,  while  in  the  middle  of  parser. 

*/ 

public  static  final  int  ParserEOFExceptionCode  =14; 


J  *  * 

*  ExceptionMessage,  String  of  the  exception  in  array  for  indexing. 
*/ 

public  static  final  String [] 

Except ionMessage=  { "NotDef inedExceptionCode" , 
null , null, null , null, null , 
null /null, null, 

"Parser:  Exception  Error", 
"Parser:  Wrong  Type  Code", 
"Parser:  Syntax  Error", 
"Parser:  State  Error", 
"Parser:  EOF  detected"}; 


/** 

*  errorCode  defines  the  type  of  exception  that  occur 
*/ 

public  int  errorCode; 

/** 

*  default  constructor,  no  argument. 

*/ 

public  automCodeGenException () { 
super  ()  ; 

errorCode  =  NotDef inedExceptionCode; 


I  ** 

*  Constructor. 

*  @param  code :  int  value  of  the  error  code 
*/ 

public  automCodeGenException (int  code) { 
super ( ) ; 

errorCode  =  code; 

} 

/** 

*  getErrorCode,  return  the  erro  code  of  the  exception 

*  ©return  int,  error  code 
*/ 

public  int  getErrorCode () { 
return  errorCode; 

} 

f  *  * 

*  printErrorCode ,  print  the  error  code  of  the  exception 

*  ©return  void 
*/ 

public  void  printErrorCode () { 

System. err .print In ( "***  Exception  Code:  "  +  errorCode  +  "  " 
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+  ExceptionMessage [errorCode] ) ; 


} 


} 


CLASSDEFINITION . JAVA 

// - 

//  Filename  :  classDef inition. java 
//  Version  :  1.0 
//  Compiler  :  jdk  1.2  or  J++ 

// - 

/** 

*  ©author  Cheng  Heng  Ngom 

*  ©version  1.0 

*  classDef inition  defines  all  the  fields  needed  to 

*  generate  a  class  interface.  It  contains  the  name 

*  of  the  server  and  the  naming  components. 

* 

*/ 

package  psdl2j ava . global ; 
import  java. util .Vector; 
import  java . io. Serializable; 
import  java. util .Enumeration; 

public  class  classDef inition  implements  Serializable 

{ 

/** 

*  distObjectName,  name  of  the  server 
*/ 

private  String  distObjectName; 

/** 

*  method,  stores  all  the  name  of  the  method 
*/ 

private  Vector  methods; 

/** 

*  id,  identification 
*/ 

private  Vector  id; 
j  *  * 

*  currMethod,  current  method  of  the  class  in  use 
*/ 

private  me thodDef inition  currMethod; 

/** 

*  objectPro,  object  space  properties 
*/ 

private  spaceProperties  objectPro; 

/** 

*  distributed,  is  it  an  aicg  object 
*/ 

private  boolean  distributed  =  true; 

/** 

*  packageName,  package  name  of  the  class 
*/ 
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private  String  packageName; 

/** 

*  count,  number  of  identification  id 
*/ 

private  int  count  =  0; 

/★* 

*  Default  Constructor,  initialise  all  the  values 

* 

*/ 

public  classDef inition ( ) { 

distObjectName  =  new  String ; 

/ /  create  a  new  methods  vector 

methods  =  new  Vector (); 

id  =  new  Vector ( ) ; 

objectPro  =  new  spaceProperties () ; 

packageName  =  new  String ; 

/** 

*  Constructor 

*  ©param  sName,  name  of  the  class  in  Sting 

* 

*/ 

public  classDef inition (String  sName) { 
distObjectName  =  new  String (sName) ; 

/ /  create  a  new  methods  vector 
methods  =  new  Vector ( ) ; 
id  =  new  Vector ( ) ; 

objectPro  =  new  spaceProperties () ; 
packageName  =  new  String  (  "  '*)  ; 

/*  * 

*  setName,  set  the  class  name 

*  @param  name,  new  name  in  String 

*  ©return  void 
*/ 

public  void  setName (String  name)  { 
distObjectName  =  new  String  (name) ; 

/** 

*  getName,  return  the  name  in  String 

*  ©return  String 
*/ 

public  String  getName  () { 
return  distObjectName; 

} 

J  *  * 

*  addMethod,  add  a  method  to  the  class 

*  @param  sName,  name  of  the  method  in  String 

*  ©param  sretType,  return  type  in  String 

*  @return  methodDef inition,  method  class 
*/ 

public  methodDefinition  addMethod (String  sName,  String  sretType) { 
currMethod  =  new  methodDef inition (sName,  sretType); 

/ /  add  a  new  method  into  the  vector 
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methods . addElement (currMethod) ; 
return  currMethod; 


} 

/** 

*  addMethod,  add  a  method  to  the  class  with  return  type  as  void 

*  @param  sName,  name  of  the  class  in  String 

*  @return  methodDef inition,  method  class 

*/  . 

public  methodDef inition  addMethod (String  sName) { 
currMethod  =  new  methodDefinition (sName) ; 

/ /  add  a  new  method  into  the  vector 
methods . addElement (currMethod) ; 
return  currMethod; 

} 

/** 

*  addID,  add  a  new  identification  variable 

*  @param  sName,  name  of  the  variable 

*  @param  ty,  type  of  the  varaible  in  String 

*  ©return  void 
*/ 

public  void  addID (String  sName,  String  ty) { 
variableDef inition  vd  =  new 

variableDef inition (def inition. IN, sName, ty) ; 
id. addElement (vd) ; 

//  refresh  the  ID  string 
vd.mapID  ()  ; 
getIDTypes () ; 
count  ++; 

} 

J  *  * 

*  getIDs,  return  a  list  of  identification  IDs 

*  ©return  Vector,  list  of  Ids 
*/ 

public  Vector  getIDs (){ 
return  id; 

} 

/** 

*  getMethod,  return  a  list  of  methods 

*  ©return  Vector,  list  of  Method  Definition 
*/ 

public  Vector  getMethods ( ) { 
return  methods; 

} 

/* 

*  getCurrentMethod,  return  the  current  method 

*  @return  methodDefinition 
*/ 

public  methodDefinition  getCurrentMethod () { 
return  currMethod; 

} 

/* 

*  getProperties,  return  the  space  properties  of  the  class 

*  ©return  spaceProperties 
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*/ 

public  spaceProperties  getProperties ( ) { 
return  objectPro; 

} 

/* 

*  setObject State,  set  the  space  property  distributed 

*  @param  state,  new  distribute  state  in  boolean 

*  ©return  void 
*/ 

public  void  setObjectState (boolean  state) { 
distributed  =  state; 

} 

/* 

*  getObjectState,  return  the  space  distributed  state 

*  @return  boolean,  the  state  of  the  object  (true  -use  space,  false 

*  normal  object) 

*/ 

public  boolean  getObjectState  () { 
return  distributed; 

} 

/* 

*  setPackageName,  set  the  name  of  the  package  the  class  belong  to. 

*  @param  name,  name  of  the  package 

*  ©return  void 
*/ 

public  void  setPackageName (String  name) { 
packageName  =  name; 

} 

/* 

*  getPackageName,  return  the  package  name  the  class  belong  to. 

*  ©return  String,  name  of  the  package 

* 

*/ 

public  String  getPackageName () { 
return  packageName; 

} 

/** 

*  getIDTypes,  return  the  type  follow  by  name  of  the  ID  in  String 

*  ©return  String,  eg.  int  aicgIDl,  ... 

* 

*/ 

public  String  getIDTypes  () { 

// 

Enumeration  enumIDs  =  id. elements () ; 
variableDef inition  vDef; 

String  sTemp  =  null; 
if  (enumIDs .hasMoreElements () ) { 

vDef  «  (variableDef inition)  enumIDs .next Element () ; 
sTemp  =  new  String (vDef . getType ( )  +'•+ 
vDef .getClassID () . getAICGName ( ) ) ; 
while  (enumIDs .hasMoreElements () ) { 

vDef  a  (variableDef inition)  enumIDs . next Element () ; 
sTemp  =  new  String (sTemp  +  " ,  "  +  vDef .getType ( )  +'*+ 
vDef -getClassID () .getAICGName () ) ; 
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return  sTemp; 

} 

j  *  ★ 

*  getIDNames,  return  only  the  ID  names  separated  by  comma 

*  ©return  String,  eg.  aicgIDl,  aicgID2,  etc 
*/ 

public  String  getIDNames () { 

Enumeration  enumIDs  =  id. elements () ; 
variableDef inition  vDef; 

String  sTemp  =  null; 
if  (enumIDs . hasMoreElements ( ) ) { 

vDef  =  (variableDef inition)  enumIDs . next Element () ; 
sTemp  =  new  String (vDef .getClassID  () .get AICGName ()) ; 
while  (enumIDs .hasMoreElements  0 ) { 

vDef  =  (variableDef inition)  enumIDs .nextElement 0 ; 
sTemp  =  new  String (sTemp  +  ",  "  + 

vDef .get ClassID ( ) . get AICGName ( ) ) ; 


i 

return  sTemp; 

} 

/* 

*  getNoIDs,  return  the  number  of  ID  in  this  class 

*  ©return  int,  number  of  ID 
*/ 

public  int  getNoIDs (){ 
return  count; 

} 

} 


CLASS IDDEFINITION. JAVA 


// - - 

//  Filename  :  classIDDef inition. java 
//  Version  :  1.0 
//  Compiler  :  jdk  1.2  or  J++ 

// - 

package  psdl2java .global; 

j  ** 

*  ©author  Cheng  Heng  Ngom 

*  ©version  1.0 

*  Description 

*  Defines  the  identification  structure. 

*/ 

public  class  classIDDef inition  extends  Object  { 
/** 

*  vD,  variable  class  of  the  Id 
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*/ 

private  variableDef inition  vD; 

/** 

*  aicgIDName,  local  name  of  the  ID,  used  by  the  AICG  only 
*/ 

private  String  aicgIDName; 

/** 

*  count,  local  counter. 

*/ 

static  private  int  count  =  1; 

/** 

*  default  constructor. 

*  ©param  inVD,  input  variable  Definition. 

*/ 

public  classIDDef inition (variableDef inition  inVD)  { 
aicgIDName  =  new  String ( "aicglD"  +  count); 
vD  =  inVD; 
count  ++; 

} 

/** 

*  getAICGName,  return  the  local  ID  name 

*  ©return  String,  name  of  the  local  ID 
*/ 

public  String  getAICGName () { 
return  aicgIDName; 

} 

/** 

*  getVD,  return  the  variable  Definition  of  the  class 

*  ©return  variableDef inition . 

*/ 

public  variableDef inition  getVD (){ 
return  vD; 

} 


DEFINITION . JAVA 

/ - - - - 

//  Filename  :  definition . j ava 
//  Version  :  1.0 
//  Compiler  :  jdk  1.2  or  J++ 

// - 

/** 

*  ©author  Cheng  Heng  Ngom 

*  ©version  1.0 

*  definition  defines  all  the  global  static  fields 

*  of  the  AICG  parser  and  generator 
*/ 

package  psdl2 java . global ; 

public  class  definition 

{ 

public  final  static  int  MAXNTJMBERMETHODS  =  100; 
public  final  static  int  MAXRESERVEWORDS  =  100; 
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public  final  static  int  MAXTOKEN  =  31; 
public  final  static  int  MAXFIX  =  31; 


//  for  future  ada  implemetation--  not  used  for  java 
public  final  static  int  IN  =  0; 
public  final  static  int  OUT  =  1; 
public  final  static  int  INOUT  =2 ; 

//  java  primitive  type 
public  final  static  int  SBOOLEAN  =  1; 
public  final  static  int  SCHAR  =  2; 
public  final  static  int  SBYTE  =  3; 
public  final  static  int  SSHORT  =  4; 
public  final  static  int  SINT  =  5; 
public  final  static  int  SLONG  =  6; 
public  final  static  int  S FLOAT  =  7; 
public  final  static  int  SDOUBLE  =  8; 


//java  non-primitive  type 

public  final  static  int  SSTRING  =  9; 

public  final  static  int  VECTOR  =  11; 

//  java  undeclare  type 

public  final  static  int  SVOID  =  10; 

//  user  define  type 

public  final  static  int  SUSERTYPE  =  0; 

//  Java  object  for  primitive  type 

public  final  static  String []  SOBJECT=  {  null,  "Boolean", 
"Character" , 

"Byte",  "Short", 

"Integer", "Long",  "Float", 
"Double" ,  "String" , 

"void" } ; 

//  java  primitive  type 

public  final  static  String []  SPRIMITIVE  =  {  null,  "boolean", 
"char", 

"byte" ,  "short" , 

"int", "long",  "float", 
"double" ,  "String" , 

"void" } ; 


//  SPACE  method  properties 

public  final  static  int  SPCONSTRUCTOR  =  0; 
public  final  static  int  SPREAD  =  1; 
public  final  static  int  SPWRITE  =  2; 
public  final  static  long  SPTTIME  =  2000; 

public  final  static  int  SPYES  =  1; 
public  final  static  int  SPNO  =  0; 
public  final  static  int  SPSERVER  =  0; 
public  final  static  int  SPSERVERS  =  1; 
public  final  static  int  SPALL  =  2; 
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public  final  static  int  SPMANY  =  11; 

public  final  static  int  SPONE  =  10; 

//  default  setting 

public  static  String  DEFAULTPACKAGENAME  =  "interfaceAICG" ; 

public  static  final  String  DEFAULTS PACENAME  =  "DODSpaces" ; 

/** 

*  spaceTranslate,  translate  a  String  name  into  the 

*  AICG  enumerate  type 

*  @param  name.  String  of  the  type 

*  ©return  int,  the  enmumerate  type 

*/ 

public  static  int  spaceTranslate (String  name) 
throws  automCodeGenExcept ion { 

if  ( name. compareTo ("CONSTRUCTOR”)  ==  0) { 
return  SPCONSTRUCTOR; 

}else  if  (name  .  compareTo  ( " READ'1)  ==  0)  { 
return  SPREAD; 

}else  if  (name . compareTo ( "WRITE" )  ==  0) { 
return  SPWRITE; 

}else  if  (name . compareTo ( "YES”) ==  0) { 
return  SPYES; 

}else  if  (name . compareTo ( "NO" ) ==  0) { 
return  SPNO; 

}else  if  (name . compareTo ( "SERVER" ) ==  0) { 
return  SPSERVER; 

} else  if  (name. compareTo  ("SERVERS") ==  0)  { 
return  SPSERVER S; 

}else  if  (name . compareTo ( "ALL" ) ==  0) { 
return  SPALL; 

}else  if  (name. compareTo ( "MANY" )==  0) { 
return  SPMANY; 

}else  if  (name . compareTo ( "ONE" ) ==  0) { 
return  SPONE; 

}else{ 

throw  new  automCodeGenException ( 

automCodeGenExcept ion. ParserWrongTypeCode) ; 

}  } 


} 


METHODDEFINITION . JAVA 

II  — - 

//  Filename  :  methodDefinition. java 
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//  Version  :  0.2 
//  Compiler  :  jdk  1.2  or  J++ 

// - 

/  ** 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

*  methodDef inition  defines  the  method  and  it  parameters 

* 

*/ 

package  psdl2 java. global; 
import  java. io. Serializable; 
import  java. util. Vector; 
import  java. util .Enumeration; 

public  class  methodDef inition  implements  Serializable 

{ 

/** 

*  paramters,  input  and  output  fields  of  the  method 
*/ 

private  Vector  parameters; 

/** 

*  name,  name  of  the  method 
*/ 

private  String  name; 

/** 

*  returnType,  return  type  in  String 
*/ 

private  String  returnType; 

/** 

*  enumeration  type  of  the  return  type 
*/ 

private  int  rtype; 

j  *  * 

*  spacemode,  mode  : SPREAD,  SPWRITE,  SPCONSTRCUCTOR 
*/ 

private  int  spaceMode  =  definition. SPREAD; 

/** 

*  spaceTransaction,  define  the  transaction  control  on 

*  the  method. (SPYES,  SPNO) 

*/ 

private  int  spaceTransaction  =  definition. SPNO; 

*  spaceTransactionTime,  define  the  time  the  transaction  must 

*  commit  before  it  expire. (  nnnn  ms,  deafult  2000ms) 

*/ 

private  long  spaceTransactionTime  =  definition. SPTTIME; 

j  ** 

*  Constructor. 

*  ©param  mname,  name  of  the  method 
*/ 

public  methodDef inition (String  mname) { 
parameters  =  new  Vector (); 
name  =  new  String (mname) ; 
returnType  =  new  String ( "void” ) ; 
rtype  =  variableDef inition. javaType ( "void" ) ; 

} 
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/** 

*  Constructor. 

*  ©param  mname,  name  of  the  method 

*  ©param  returnValue,  return  type 
*/ 

public  methodDef inition (String  mname.  String  returnValue) { 
parameters  =  new  Vector (); 
name  =  new  String (mname) ; 
returnType  =  new  String  (returnValue) ; 
rtype  =  variableDef inition. javaType (returnValue) ; 


/** 

*  setRetType,  modifies  the  return  type  of  the  method 

*  ©param  returnValue,  return  type  in  String 

*  ©return  void 
*/ 

public  void  setRetType (String  returnValue) { 

rtype  =  variableDef inition. javaType (returnValue) ; 
if  (rtype  ==  definition . SUSERTYPE) { 
returnType  =  new  String (returnValue) ; 

}else  { 

returnType  =  new  String (definition. SPRIMITIVE [rtype] ) ; 


} 

/** 

*  getRetType,  return  the  return  type  of  the  method 

*  @return  String,  return  type  in  String 
*/ 

public  String  getRetType () { 
return  returnType; 

/** 

*  getJavaRetType,  return  the  return  type  in  Java  object  enumerate 

*  type 

*  @return  int,  enumerate  type  in  int 
*/ 

public  int  get JavaRetType ( ) { 
return  rtype; 


I  *  * 

*  addParameter ,  add  new  input. output  parameter  into  the  method 

*  @param  dir,  input,  output  or  both 

*  ©param  n,  name  of  the  variable 

*  @param  ty,  type  of  the  variable 

*  @return  void 
*/ 

public  void  addParameter (int  dir,  String  n.  String  ty) { 
variableDef inition  vd  =  new  variableDef inition (dir, n,  ty) ; 
parameters . addElement (vd) ; 


J  ** 
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*  getName,  return  the  name  of  the  methods 

*  ©return  String,  name  of  the  method 
*/ 

public  String  getName(){ 
return  name; 

} 

/** 

*  getParameters,  return  the  list  of  parameter 

*  @return  Vector,  list  of  vairableDef inition 
*/ 

public  Vector  getParameters () { 
return  parameters; 

} 

/** 

*  getParametersS tring ,  return  the  list  of  parameter 

*  ©return  String,  list  of  VairableDef inition  in  the  form 

*  Integer  name.  Float  etc 

*/  . 
public  String  getParameterString ( ) { 

Enumeration  enumIDs  =  parameters . elements () ; 
variableDef inition  vDef; 

String  sTemp  =  new  String (); 
int  counter  =  0; 

if  (enumIDs . hasMoreElements  0 ) { 

vDef  =  (variableDef inition)  enumIDs .nextElement () ; 
sTemp  =  new  String (vDef . toString ()) ; 
while  (enumIDs . hasMoreElements ( ) ) { 

vDef  =  (variableDef inition)  enumIDs .nextElement 0 ; 
if  (  counter  ==  0) { 

sTemp  =  new  String (vDef . toString ()) ; 

}else{ 

sTemp  -  new  String (sTemp  +  " ,  "  +  vDef . toString ()) ; 

} 

counter**; 


return  sTemp; 

} 

/** 

*  getParameterName,  return  the  list  of  parameter  names  of  the 
method 

*  ©return  String,  the  name  of  the  parameters  in  aicgIDl,  aicgID2 
*/ 

public  String  getParameterName () { 

Enumeration  enumIDs  =  parameters . elements () ; 
variableDef inition  vDef; 

String  sTemp  =  new  String (); 
if  (enumIDs .hasMoreElements  0 ) { 

vDef  =  (variableDef inition)  enumIDs .nextElement () ; 
sTemp  =  new  String (vDef . getID ()) ; 
while  (enumIDs. hasMoreElements () ) { 

vDef  =  (variableDef inition)  enumIDs . nextElement (); 
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sTemp  =  new  String (sTemp  +  ",  "  +  vDef .getID () ) ; 

}  } 

return  sTemp; 


j  *  * 

*  setReadProperty,  set  the  method  whether  it  is 

*  a  read,  or  write. 

*  @param  int,  0  :  read,  1:  write 

*  @return  void 
*/ 

public  void  setReadProperty (int  mode) { 
spaceMode  =  mode; 

if  (  spaceMode  ==  definition. SPCONSTRUCTOR) { 
returnType  =  new  String ( ) ; 


/** 

*  getReadProperty,  return  the  read  property 

*  ©return  int,  0:  constructor,  l:read,  2:  write 
*/ 

public  int  getReadProperty ( ) { 
return  spaceMode; 

} 

/** 

*  setTransaction,  set  whether  transaction  is  enable  for  this 
method 

*  ©return  void 
*/ 

public  void  setTransaction (int  ty) { 
spaceTransaction  =  ty; 

} 

/*  * 

*  getTransaction,  return  the  value  of  transaction 

*  @  return  int,  SPYES  :  transaction  enable,  SPNO:  transaction 
disable 

*/ 

public  int  getTransaction () { 
return  spaceTransaction; 

} 

/** 

*  setTransactionTime,  set  the  transaction  time  before  it  expire 

*  @param  ty,  time  in  minisecond 

*  @return  void 
*/ 

public  void  setTransactionTime (long  ty) { 
spaceTransactionTime  =  ty; 


j  *  * 

*  getTransactionTime,  return  the  transaction  time  of  the  method 

*  @return  long,  the  transaction  time  in  miniseconds 
*/ 

public  long  getTransactionTime () { 
return  spaceTransactionTime ; 
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} 


} 


READER. JAVA 

// - 

//  Filename  :  reader. java 
//  Version  :  1.0 
//  Compiler  :  jdk  1.2  or  J++ 
// - 

package  psdl2 java. global; 

import  java.io.*; 


/** 

*  Class  reader 

* 

*  @author  Cheng  Heng  Ngom 

*  @version  0.1 

* 

*  Description 

*  An  abstract  class  that  get  the  reserve  words  from  a  file  and 

*  set  up  the  tokenizer  for  the  input  file 
*/ 


public  abstract  class  reader 

{ 

I  *  * 

*  arrays  of  reserve  words 
*/ 

protected  String  reserveWords [] ; 

/** 

*  Reader  file  to  obtain  the  input  to  be  parsed 
*/ 

private  Buf f eredReader  inReader; 

J  ** 

*  Reader  file  to  obtain  the  reserve  words  of  the  languages 
*/ 

private  Buf feredReader  reserveFileReader; 

/** 

*  Input  Stream  Token 
*/ 

protected  StreamTokenizer  inStreamTokenizer; 

j  *  * 

*  Arguments  Constructor, 
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*  ©param  inFileName:  input  PSDL  file 

*  ©param  reserveFileName :  reserve  words  text  file 
*/ 

public  reader (String  inFileName,  String  reserveFileName) 
throws  automCodeGenException{ 

//  check  if  the  file  exist 
try{ 

inReader  =  new  Buf f eredReader (  new  FileReader  (inFileName)  )  ; 
reserveFileReader  -  new  Buf f eredReader (  new 
FileReader (reserveFileName) ) ; 

} catch  (IOException  e) { 

System. err .println ( "File  open  error") ; 
throw  new 

automCodeGenException (automCodeGenException . ParserExceptionCode) ; 
reserveWords  =  new  String [definition. MAXRESERVEWORDS] ; 
try{ 

//  get  the  reserve  words 
getReserve  ()  ; 

//  initialise  the  stream  tokenizer 
initStreamTokenizer ()  ; 

} catch  (automCodeGenException  e) { 

throw  new  automCodeGenException (e . errorCode) ; 


} 

/** 

*  getReserve,  gets  the  reserve  words  from  a  file  and  save  it  on 

*  an  array. 

*  ©return  void 

*  ©exception  automCodeGenException 
*/ 

private  void  getReserve () throws  automCodeGenException  { 
int  srType; 
int  i  =0; 
try  { 

StreamTokenizer  sReserve  =  new 
StreamTokenizer (reserveFileReader) ; 

//  ignore  the  EOL 
sReserve . eollsSignif icant (false) ; 
sReserve . ordinaryChar ( 95 ) ; 
srType  =  sReserve .nextToken () ; 

while  (srType  !=  StreamTokenizer . TT_EOF) { 
if  (srType  ==  StreamTokenizer .TT_W0RD) { 

reserveWords [i]  =  new  String  (sReserve . sval) ; 
i++; 

srType  =  sReserve .nextToken () ; 

} 

}//  end  of  while 
}catch  (Exception  e) { 

throw  new  automCodeGenException ( 

automCodeGenException. ParserExceptionCode) ; 
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f  it* 

*  initStreamTokenizer,  provide  basic  initization  of  the  input 

*  tokens,  should  be  overrrided  for  customization. 

*  ©return  void; 

*  ©exception  automCodeException 
*/ 


public  void  initStreamTokenizer ( )  throws  automCodeGenException 

inStreamTokenizer  =  new  StreamTokenizer (inReader) ; 
inStreamTokenizer . eollsSignif icant (true) ; 

//  any  other  initialise  needed? 


} 


j  *  * 

*  Abstract  method  to  be  implemented  by  the  sub  class  on  how  the 

*  tokens  is  used 
*/ 

public  abstract  String  getNextToken (boolean  checkEOL)  throws 
automCodeGenException ; 

j  *  * 

*  Abstract  method  to  define  the  main  production  of  the  grammmars . 
*/ 

public  abstract  boolean  mainProduction ( )  throws 
automCodeGenException; 


}//  end  of  class 


SPACEPROPERTIES . JAVA 

// - 

//  Filename  :  spaceProperties . j ava 
//  Version  :  1.0 
//  Compiler  :  jdk  1.2  or  J++ 

// - 

j  ** 

*  ©author  Cheng  Heng  Ngom 

*  ©version  1.0 
*/ 

package  psdl2 java. global; 
import  java . io . Serializable; 
j  *  * 

*  spaceProperties  defines  all  the  fields  for  the  AICG 

*  space  generated  interface. 
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*/ 

public  class  spaceProperties  implements  Serializable 
/** 

*  spaceName,  name  of  the  space  to  use 
*/ 

private  String  spaceName; 

/** 

*  ownership,  allows  server  to  use  the  object 
*/ 

private  int  ownership  =  definition . SPYES ; 

/** 

*  security,  type  of  security;  server/all 
*/ 

private  int  security  =  definition. SPSERVER; 
j  *  * 

*  lease,  time  in  ms  before  the  object  expired 
*/ 

private  long  lease  =  Long . MAX_VALUE  ; 

/** 

*  clone,  duplication  allow 
*/ 

private  int  clone  =  definition. SPONE; 

/** 

*  notify,  notication  of  modification  enable/disable 
*/ 

private  int  notify  =  definition. SPNO; 
j  *★ 

*  constructor,  create  a  new  space  properties  with 

*  default  setting. 

* 

*/ 

public  spaceProperties () { 

spaceName=  new  String ( "DODSpaces ") ; 

ownership  =  def inition. SPYES; 

security  =  def inition. SPSERVER; 

lease  =  Long .  MAX_VALUE  ; 

clone  =  def inition. SPONE; 

notify  =  definition. SPNO; 

j  *  ★ 

*  Argument  constructor 

*  @param  name,  Name  of  the  Space 

*  ©param  own,  ownership 

*  ©param  sec,  security 

*  ©param  duration,  lease  time  in  ms 

*  ©param  num,  clone  number 

*  ©param  notifyln,  notification  enable  or  disable 
*/ 

public  spaceProperties  (String  name,  int  own,  int  sec,  int  duration, 

int  num,  int  notifyln) { 
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spaceName=  new  String (name) ; 

ownership  =  own; 

security  =  sec; 

lease  =  duration; 

clone  =  num; 

notify  =  not if yin; 

} 

/** 

*  setName,  change  the  name  of  the  space 

*  @param  name,  name  of  the  new  space 

*  @return  void 
*/ 

public  void  setName (String  name) { 
spaceName  =  name; 

} 

/*★ 

*  getName  return  the  name  of  the  space 

*  ©return  String,  name  of  the  space 
*/ 

public  String  getName (){ 
return  spaceName; 

} 

/** 

*  setOwnership,  set  the  ownership  properties 

*  ©param  own,  new  ownership 

*  ©return  void 
*/ 

public  void  setOwnership (int  own) { 
ownership  =  own; 

} 

/** 

*  getOwnership,  return  the  ownership  value 

*  @return  int,  ownership  value 
*/ 

public  int  getOwnership () { 
return  ownership; 

} 

/** 

*  setSecurity,  set  the  security  property 

*  ©param  indata,  security  value 

*  ©return  void 
*/ 

public  void  setSecurity (int  indata) { 
security  =  indata; 

} 

/** 

*  getSecurity,  return  teh  security  value 

*  ©return  int,  security  value 
*/ 

public  int  getSecurity () { 
return  security; 

} 
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/** 

*  setLease,  set  the  lease  in  ms 

*  @param  indata,  new  lease  in  ms 

*  ©return  void 
*/ 

public  void  setLease (long  indata) { 
lease  =  indata; 

} 

I  *  * 

*  getLease,  return  the  lease  in  ms 

*  ©return  long,  lease  in  ms 
*/ 

public  long  getLease (){ 
return  lease; 

} 

/** 

*  setClone,  set  the  number  of  clone  allow 

*  ©param  indata,  number  of  clone  allow 

*  ©return  void 
*/ 

public  void  setClone (int  indata) { 
clone  =  indata; 

} 

/** 

*  getClone,  return  the  number  of  clone 

*  ©return  int,  number  of  clone  allow 
*/ 

public  int  getClone (){ 
return  clone; 

} 

/** 

*  setNotify,  set  the  notify  for  modification 

*  ©param  indata,  value  of  the  notify 

*  ©return  void 
*/ 

public  void  setNotify (int  indata) { 
notify  =  indata; 

} 

/** 

*  getNotify,  return  the  value  of  notify 

*  @return  int,  value  of  notify 

V 

public  int  getNotify (){ 
return  notify; 

}  1 


VARAIBLEDEFINITION . JAVA 

// - - 

//  Filename  :  variableDef inition. java 
//  Version  :  1.0 
//Compiler  :  jdk  1.2  or  J++ 

// - 
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package  psdl2j ava . global ; 
import  j ava . io . Serializable ; 

/** 

*  ©author  Cheng  Heng  Ngom 

*  ©version  0.1 

*  variableDef inition  defines  a  type  definition. 

*  input/ouput  type__id  :  type 

* 

*/ 

public  class  variableDef inition  implements  Serializable 

{ 

/** 

*  io,  state  whether  the  variable  is  an  input  or  output 
*/ 

private  int  io  =  definition. IN; 

j  -k-k 

*  varlD,  name  of  the  variable 
*/ 

private  String  varlD; 

/** 

*  stype,  type  of  the  variable  in  String 
*/ 

private  String  stype; 

j  *  * 

*  itypem  type  of  variable  in  integer  enumerated 
*/ 

private  int  itype; 

j  k-k 

*  cID,  keep  track  of  the  aicg  names  used  in  conjuction  with  this 

*  variable 
*/ 

private  classIDDef inition  cID; 

/★* 

*  Default  Constructor. 

*  ©param  sio,  new  input  or  output  state 

*  ©param  id,  name  of  the  variable 

*  ©pram  ty,  type  of  the  variable 

* 

*/ 

public  variableDef inition (int  sio,  String  id.  String  ty) { 
io  =  sio; 

varlD  =  new  String (id); 
itype  =  javaType (ty) ; 
if  (itype  ==  definition. SUSERTYPE) { 
stype  =  new  String (ty); 

}else  { 

stype  =  new  String (definition. SPRIMITIVE [itype] ) ; 

} 

} 

I  *  * 

*  getID,  return  the  name  of  the  variable 
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*  ©return  String,  name  of  the  variable 
*/ 

public  String  getID(){ 
return  varlD; 

} 

f  ** 

*  getType,  return  the  type  of  the  variable 

*  @return  String,  type  of  the  variable 
*/ 

public  String  getType (){ 
return  stype ; 

} 

/** 

*  getIType,  return  the  type  of  the  variable  in  integer 

*  enumeration. 

*  @return  int,  type  of  the  variable  in  int  enumeration 
*/ 

public  int  getIType (){ 
return  itype; 

} 

/** 

*  javaType,  convert  the  String  type  into  int  enumeration 

*  type . 

*  @param  stype,  type  in  String. 

*  ©return  int,  enumeration  type  of  the  input  String 
*/ 

public  static  int  javaType (String  stype) { 

//  java  primitive  type 
if  ( stype. compareTo( "boolean" )==0)  { 
return  definition. SBOOLEAN; 

}else  if  (stype . compareTo ( "char" ) ==0) { 
return  definition. SCHAR; 

}else  if  (stype .compareTo ( "byte") ==0) { 
return  def inition. SBYTE; 

}else  if  (stype. compareTo ( "short ") ==0) { 
return  def inition. SSHORT; 

}else  if  (stype. compareTo ("integer") ==0) { 
return  definition. SINT; 

}else  if  (stype. compareTo ("long") ==0) { 
return  def inition. SLONG; 

}else  if  ( stype. compareTo ( "f loat ") ==0 ) { 
return  def inition. SFLOAT; 

}else  if  ( stype. compareTo ( "double ") ==0 ) { 
return  definition. SDOUBLE; 

}else  if  (stype. compareTo ("string") ==0) { 
return  def inition. SSTRING; 

}else  if  (stype . compareTo ( "void" ) ==0)  { 
return  def inition. SVOID; 

}else  { 

return  def inition. SUSERTYPE; 


/** 
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*  getJavaObject,  return  the  type  convert  to  Java  Object  in  String 

*  ©return  String,  type  of  the  variable  in  Java  Object 
*/ 

public  String  getJavaObject ()  { 

return  definition. SOB JECT [itype] ; 

} 

/** 

*  toString,  override  the  base  method. 

*  ©return  String,  variable  declaration  format 

*  eg.  Integer  idl 
*/ 

public  String  toString (){ 
return  stype  +  '  '  +  varlD; 

} 

/** 

*  mapID,  create  a  new  classIDDef inition  for  this  object 

*  ©return  void 
*/ 

public  void  mapID(){ 

cID  =  new  classIDDef inition (this) ; 

} 

j  *  * 

*  getClassID,  return  the  classIDDef inition  create  for  this  object 

*  ©return  classIDDef inition,  ClassIDObj ect  for  this  object 
*/ 

public  classIDDef inition  getClassID ( ) { 
return  cID; 


PSDLDEFINITION.  JAVA 

/ - 

//  Filename  :  psdlDef inition. java 
//  Version  :  1.0 
//  Compiler  :  jdk  1.2  or  J++ 

// - 

package  psdl2 java .parser ; 

/** 

*  ©author  Cheng  Heng  Ngom 

*  ©version  1.0 

*  psdlDef inition  interface  defines  al  the  constants  used 

*  by  the  AICG. 

*/ 

public  interface  psdlDef inition 

{ 


final 

int 

TYPE  =  0; 

final 

int 

OPERATOR  =  1; 

final 

int 

SPECIFICATION  =  2; 

final 

int 

IMPLEMENTATION  =  3; 

final 

int 

GRAPH  =4; 

final 

int 

EDGE  =  5; 

final 

int 

STATES  =  6; 
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final  int  INPUT  =  7; 
final  int  OUTPUT  =  8; 
final  int  PROPERTY  =  9; 
final  int  AXIOMS  =  10; 
final  int  VERTEX  =11; 
final  int  GENERIC  =  12; 

final  int  IF  =  13; 
final  int  MS  =  14; 
final  int  SEC  =  15; 
final  int  END  =  16; 
final  int  MIN  =  17; 
final  int  MICROSEC  =  18; 
final  int  KEYWORDS  =  19; 

final  int  TRIGGERED  =  20; 
final  int  EXCEPTION  =  21; 
final  int  INITIALLY  =  22; 
final  int  EXCEPTIONS  =  23; 
final  int  DESCRIPTION  =  24; 
final  int  OR  =  25; 
final  int  AND  =  26; 
final  int  MOD  =  27; 
final  int  REM  =  28; 
final  int  XOR  =  29; 
final  int  DIGIT  =  30; 
final  int  LETTER  =  31; 
final  int  TRUE  =  32; 
final  int  FALSE  =  33; 
final  int  TIMER  =  34; 
final  int  HOURS  =  35; 
final  int  PERIOD  =  36; 
final  int  EOL  =37; 

//  added  new  Definition 

final  int  CORBA  =  38; 
final  int  JAVA  =  39; 
final  int  SPACE  =  40; 
final  int  SPACEMODE  =  41; 
final  int  READ  =  42; 
final  int  WRITE  =  43; 
final  int  CONSTRUCTOR  =  44; 
final  int  SPACENAME  =  45; 
final  int  SPACELEASE  =  46; 
final  int  SERVER  =  47; 
final  int  EXTENDED  =48; 
final  int  SPACESECURITY  =  49; 
final  int  SERVERS  =  50; 
final  int  ALL  =  51; 
final  int  OWNERSHIP  =  52; 
final  int  SECURITY  =  53; 
final  int  LEASE  =  54; 
final  int  CLONE  =  55; 
final  int  NOTIFY  =  56; 
final  int  TRANSACTION  =  57; 
final  int  TRANSACTIONTIME  =  58; 
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} 


PSDLREADER . JAVA 

// - 

//  Filename  :  psdlReader . java 
//  Version  :  1.0 
//  Compiler  :  jdk  1.2  or  J++ 

// - 

package  psdl2 java. parser; 

import  java.io.*; 
import  j ava .util .Vector ; 

import  psdl2 java. global.*; 

/** 

*  ©author  Cheng  Heng  Ngom 

*  ©version  1.0 

*  psdlReader  implement  the  reader  which  check  the 

*  syntax  of  the  PSDL  input  file  and  extract  the  necessry 

*  information 

*/  ... 
public  class  psdlReader  extends  reader  implements  psdlDef mition 

{ 

/** 

*  Name  of  the  server 
*/ 

private  Vector  distObject; 

/** 

*  class  properties  of  the  interface 
*/ 

private  classDef inition  mainServerClass ; 


/** 

*  Argumentals  constructor. 

*  ©param  inFileName,  name  of  the  PSDL  input  file 

*  ©param  reserveFileName,  name  of  the  PSDL  reserve  file  name 

*/ 

public  psdlReader (String  inFileName,  String  reserveFileName) 
throws  automCodeGenException{ 

super (inFileName, reserveFileName) ; 

//  initialise  the  distObject  list 
distObject  =  new  VectorO; 

//include  1 : '  as  a  white  space 
inStreamTokenizer . whitespaceChars (58,58) ; 

//include  1 =*  as  a  white  space 
inStreamTokenizer .whitespaceChars ( 1 = 1 , 1 = 1 ) ; 

//  include  as  a  character 

inStreamTokenizer .wordChars (95,95) ; 
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} 

/** 

*  getNextToken,  get  the  next  token  from  the  input  stream 

*  @param  checkEOL,  if  true,  EOL  is  treaded  as  a  token  else  ignored 

*  ©return  String,  the  token 
*/ 

public  String  getNextToken (boolean  checkEOL)  throws 
automCodeGenException{ 

try{ 

while  (true) { 

inStreamTokenizer . nextToken ( ) ; 

if  (inStreamTokenizer .ttype  !=  StreamTokenizer . TT_EOF) { 
if  (inStreamTokenizer. ttype  ==  StreamTokenizer .TT_WORD) 

return  inStreamTokenizer. sval; 

}else  if  (inStreamTokenizer .ttype  == 

StreamTokenizer .TT  EOL) 

{ 

if  (checkEOL) { 
return  null; 

} 

}else  throw  new  automCodeGenException ( 

automCodeGenException . ParserWrongTypeCode)  ; 

}else  { 

throw  new  automCodeGenException ( 

automCodeGenException . ParserEOFExceptionCode ) ; 

}//  end  of  While 

} catch  (IOException  e) { 

throw  new  automCodeGenException ( 

automCodeGenException . ParserExceptionCode)  ; 

}  } 

j  *  * 

*  getNextToken,  check  if  the  next  token  from  the  input  stream  is 

*  the  same  as  the  input  reserve  word. 

*  ©param  waitOn,  the  reserve  word  to  be  used  for  compare 

*  ©return  void, 

*  ©exception  automCodeException,  IOException. 

*/ 

public  void  getNextToken (int  waitOn)  throws  automCodeGenException, 
IOException{ 

String  tempStr; 
if  (waitOn  !=  EOL) { 
while  (true) { 

inStreamTokenizer . nextToken ( ) ; 

if  (inStreamTokenizer. ttype  !=  StreamTokenizer . TT_EOF) { 
if  (inStreamTokenizer .ttype  ==  StreamTokenizer . TT_WORD) { 
tempStr  =  new  String (inStreamTokenizer . sval) ; 
if  (tempStr . compareTo (reserveWords [waitOn]  )==0) { 
break; 

}else  { 

//  not  the  correct  waitOn  type 
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} 


throw  new  automCodeGenException ( 

automCodeGenException. Par serWrongType Code) ; 

}else  { 

throw  new  automCodeGenException ( 

automCodeGenException. ParserEOFExceptionCode)  ; 

} 

}//  end  of  while 

}else  //  equal  to  EOL,  remove  all  token  of  that  line 

{ 

while  (true) { 

inStreamTokenizer . nextToken ( ) ; 

if  ( inStreamTokenizer. ttype  !=  StreamTokenizer.TT_EOF) { 
if  (inStreamTokenizer. ttype  ==  StreamTokenizer .TT_EOL) { 
break; 

} 

}else  { 

throw  new  automCodeGenException ( 

automCodeGenException. ParserEOFExceptionCode) ; 

} 

}//  end  of  while 

} 

} 

/** 

*  getNumNextToken,  get  the  number  from  the  input  stream 

*  ©param  checkEOL,  if  true,  EOL  is  treaded  as  a  token  else  ignored 

*  ©return  String,  the  token 
*/ 

public  long  getNumNextToken  (boolean  checkEOL)  throws 
automCodeGenException { 

try{ 

while  (true) { 

inStreamTokenizer . nextToken ( ) ; 

if  (inStreamTokenizer .ttype  !=  StreamTokenizer .TT_EOF) { 
if  (inStreamTokenizer. ttype  ==  StreamTokenizer. TT_NUMBER) 

{ 

return  (int) inStreamTokenizer. nval; 

}else  if  (inStreamTokenizer. ttype  == 

StreamTokenizer . TT_EOL) 

if  (checkEOL) { 
return  -1; 

} 

}else  throw  new  automCodeGenException ( 

automCodeGenException.  Par  serWrongType  Code)  ; 

}else  { 

throw  new  automCodeGenException ( 

automCodeGenException . ParserEOFExceptionCode) ; 

} 

}//  end  of  While 

} catch  (IOException  e) { 

throw  new  automCodeGenException ( 

automCodeGenException. ParserExceptionCode) ; 

} 
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} 


/*  * 

*  Method  to  define  the  main  production  of  the  grammmars . 

*/ 

public  boolean  mainProduction ()  throws  automCodeGenException{ 
int  currentProduction  =  0  ; 

String  tempS  =  " " ; 

String  tempS2; 

String  tempS3; 

try  { 

while  (true) { 

switch  (currentProduction) { 

//Type 

case  0  :  getNextToken (TYPE)  ; 

currentProduction  =  10; 
break; 

case  10:  tempS  =  new  String  (getNextToken (false) ) ; 

/ /  initialise  a  new  class  definition  without  any  parameters 
mainServerClass  =  new  classDef inition ( ) ; 
mainServerClass . setName (tempS) ; 
currentProduction  =  20; 
break; 

/ /Specification 

case  20:  getNextToken (SPECIFICATION) ; 
currentProduction  =  30; 
break; 

//  get  the  identification  varaibles 

case  30:  tempS  =  new  String  (getNextToken(false)); 

if (tempS. compareTo (reserveWords [END] )  ==  0) { 
currentProduction  =40; 

}else  { 

tempS2  =  new  String (getNextToken (false) ) ; 
mainServerClass .addID (tempS, tempS2) ; 

break; 

//  OPERATOR  &  IMPLEMENTATION 

case  40:  tempS  =  new  String (getNextToken (false) ) ; 

if  (tempS . compareTo (reserveWords [OPERATOR] )  ==  0) { 
operatorProductionO ; 

}  else  if  (tempS . compareTo ( 

reserveWords [IMPLEMENTATION] )  ==  0) { 
currentProduction  =50; 

}  else  { 

throw  new  automCodeGenException ( 

automCodeGenException . ParserSyntaxError ) ; 

break; 

case  50:  tempS  =  new  String (getNextToken (false) ) ; 

if  (tempS. compareTo (reserveWords [SPACE] )  ==  0) { 
spaceProduction () ; 
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currentProduction  =  60; 

}else  if  (tempS . compareTo (reserveWords [END] )  ==  0) { 
currentProduction  =  60; 

}else  if  ( tempS. compareTo (reserveWords [JAVA] )  ==  0) { 
mainServerClass . setObjectState (false) ; 
tempS2  =  new  String (getNextToken (false) ) ; 
mainServerClass  .  setPackageName  (tempS2 )  ; 


} 

break; 

case  60:  distObject . addElement (mainServerClass) ; 

tempS  =  new  String (getNextToken (false) ) ; 
if  (tempS .compareTo (reserveWords [TYPE] )==0) { 
currentProduction  =  10; 

}else  { 

throw  new  automCodeGenException  ( 

automCodeGenException .  ParserSyntaxError )  ; 

} 

break;  //  end  state,  when  the  EOF  is  reach 

}//  end  of  switch 
}//  end  of  while 

} catch  (automCodeGenException  e)  { 
if  ( (e . errorCode  == 

automCodeGenException . ParserEOFExceptionCode) 

&  (currentProduction  ==  60))  { 

System. err. println ("Phase  1  :  Parser  Completed  without 

error") ; 

return  (true) ; 

} 

Sys tem. err. print In ("  ***  Parser  error  detected  ***"); 
e . printErrorCode ( )  ; 

System.err.println("***  On  line  number  "  + 
inStreamTokenizer . lineno ( ) ) ; 
return  (false) ; 

} catch  (IOException  e) { 

System. err .print In ( ”  ***  10  error  detected  ***"); 

Sys tem. err .print In ("***  On  line  number  "  + 
inStreamTokenizer . lineno ( ) ) ; 
return  (false) ; 

} 

}//  end  of  main  production 
/** 

*  operatorProduction,  parse  the  methods  of  the  objects 

*  ©exception,  automCodeGenException  and  IOException 

*  ©return  void 
*/ 

private  void  operatorProduction ( )  throws  automCodeGenException, 
IOException { 

int  currentProduction  =0; 

String  stempl; 

String  stemp2; 

methodDef inition  currentMethod  =  new  methodDef inition ( " " ) ; 
while  (true) { 

switch  (currentProduction) { 
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case  0  :  stempl  =  new  String  (getNextToken (false) ) ; 

currentMethod  =  mainServerClass  .  addMethod  (stempl)  ; 

currentProduction  =  10; 

break; 

case  10:  getNextToken (SPECIFICATION) ; 
currentProduction  =2  0; 
break; 


0){ 


case  20:  stempl  =  new  String  (getNextToken (false) ) ; 

if  (stempl .compareTo (reserveWords [INPUT] )  ==  0) { 
stempl  =  new  String  (getNextToken (false) ) ; 
s temp 2  =  new  String  (getNextToken (false) ) ; 
currentMethod . addParameter 

(definition. IN, stempl, stemp2) ; 

}else  if  ( stempl. compareTo (reserveWords [OUTPUT] )  == 

/ /  the  first  output  type  will  be  the  method  return 
/ /  type 

stempl  =  new  String  (getNextToken (false) ) ; 
s temp 2  =  new  String  (getNextToken (false) ) ; 
currentMethod . setRetType (stemp2 ) ; 
currentProduction  =30; 

}  else  if  (stempl. compareTo (reserveWords [STATES] ) 

==  0 )  { 

/ /  the  state  type  must  not  be  of  primitive  type 
stempl  =  new  String  (getNextToken (false) ) ; 
stemp2  =  new  String  (getNextToken (false) ) ; 
if  (variableDef inition. javaType (stemp2)  != 
definition. SUSERTYPE) { 
throw  new  automCodeGenException ( 
automCodeGenException . ParserStateError ) ; 


currentMethod. addParameter (definition. INOUT, stempl, 

stemp2) ; 

}else  if  (stempl. compareTo (reserveWords [END] )  ==  0) { 
currentProduction  =40; 

break; 

case  30:  stempl  =  new  String  (getNextToken (false)  )  ; 

if  (stempl. compareTo (reserveWords [INPUT] )  ==  0) { 
stempl  =  new  String  (getNextToken (false) ) ; 
s temp 2  =  new  String  (getNextToken (false) ) ; 
currentMethod. addParameter (definition. IN, stempl, 

stemp2) ; 

}else  if  (stempl. compareTo (reserveWords [OUTPUT] )  == 

0){ 

//  the  first  output  type  will  be  the  method  return 
//  type 

stempl  =  new  String  (getNextToken (false) ) ; 
stemp2  =  new  String  (getNextToken (false) ) ; 
if  (variableDef inition. javaType (stemp2)  != 
definition. SUSERTYPE) { 
throw  new  automCodeGenException ( 
automCodeGenException. ParserStateError) ; 
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currentMethod. addParameter (def ini t ion. INOUT, s tempi, 

stemp2) ; 

}  else  if  (stempl.compareTo (reserveWords [STATES] ) 

==  0)  { 

//  the  state  type  must  not  be  of  primitive  type 
stempl  =  new  String  (getNextToken (false) ) ; 
stemp2  =  new  String  (getNextToken (false) ) ; 
if  (variableDef inition. javaType (stemp2)  !  = 
definition. SUSERTYPE) { 
throw  new  automCodeGenException ( 
automCodeGenExcept ion . ParserStateError) ; 

} 

currentMethod . addParameter (definition . INOUT, stempl , 

Stemp2) ; 

}else  if  (stempl.compareTo (reserveWords [END] )  ==  0) { 
currentProduction  =40; 

} 

break; 

case  40 :  getNextToken ( IMPLEMENTATION) ; 
currentProduction  =  50; 
break; 

case  50:  stempl  =  new  String (getNextToken (false) ) ; 

if  (stempl .compareTo (reserveWords [SPACE] )  ==  0)  { 

spaceMethodProduction (currentMethod) ; 

}else  if  (stempl.compareTo (reserveWords [END] )  ==  0) { 
return; 

}else  { 

throw  new  automCodeGenException ( 

automCodeGenException . ParserSyntaxError ) ; 

} 

break; 

}//  end  of  switch 
}//  end  of  while 
}//  end  of  operatorProduction 

private  void  spaceMethodProduction (methodDef inition  currentMethod) 
throws  automCodeGenException,  IOException{ 
int  currentProduction  =0; 

String  stempl; 

String  stemp2; 

while  (true) { 

switch  (currentProduction) { 
case  0:  getNextToken (PROPERTY) ; 

currentProduction  =  10; 
break; 

case  10:  stempl  =  new  String (getNextToken (false) ) ; 

if  (stempl .compareTo (reserveWords [SPACEMODE] )  ==  0)  { 

//  space  mode 

stemp2  =  new  String (getNextToken (false) ) ; 

currentMethod. setReadProperty (definition. spaceTranslate (stemp2) ) ; 
currentProduction  =  20; 

}else  if  (stempl . compareTo (reserveWords [TRANSACTION] ) 
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==  o )  { 

//  trasaction  mode  Yes,  No 

stemp2  =  new  String (getNextToken (false) ) ; 

currentMethod . setTransaction (definition. spaceTranslate (stemp2)  )  ; 
current Product ion  =2  0; 

}else  if 

(s tempi . compareTo (reserveWords [TRANSACTIONTIME] ) 

==  0){ 

//  trasaction  time  in  ms 
long  itemp  =  ge tNumNext Token (false) ; 
currentMethod. setTransactionTime (itemp) ; 
current Production  =2  0; 

}else  { 

throw  new  automCodeGenException ( 

automCodeGenException . ParserSyntaxError) ; 


break; 

case  20:  stempl  =  new  String (getNextToken (false) ) ; 

if  (stempl . compareTo (reserveWords [PROPERTY] )  ==  0)  { 
currentProduction  =10; 

}else  if  (stempl . compareTo (reserveWords [END] )  ==  0)  { 
//  End  of  IMPLEMENTATION 
return; 

}else  { 

throw  new  automCodeGenException ( 

automCodeGenException. ParserSyntaxError)  ; 


} 

}//  end  of  while 
}//  end  of  method 

private  void  spaceProduction ()  throws  automCodeGenException, 
IOException{ 

int  currentProduction  =0; 

String  stempl; 

String  stemp2; 
spaceProperties  objectSP ; 

objectSP  =  mainServerClass . getProperties ( ) ; 
while  (true) { 

switch  (currentProduction) { 
case  0:  getNextToken (PROPERTY) ; 

currentProduction  =10; 
break; 

case  10:  stempl  =  new  String (getNextToken (false) ) ; 

if  (stempl . compareTo (reserveWords [SPACENAME] )  ==  0)  { 
//  space  name 

objectSP. setName (getNextToken (false) ) ; 
currentProduction  =  20; 

}else  if  ( stempl. compareTo (reserveWords  [OWNERSHIP] ) 
==  0)  { 

//  ownership  mode 

objectSP. setOwnership (definition. spaceTranslate 
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(getNextToken (false) ) ) ; 
current Production  =  20; 

}else  if  ( s tempi . compareTo (reserveWords [SECURITY]  ) 

0)  { 

//  security  mode 

obj  ectSP . setSecurity (definition . spaceTranslate 
(getNextToken (false)  )  )  ; 
current Product ion  =  20; 

}  else  if  ( stempl. compareTo (reserveWords [LEASE] )  = 

0)  { 

//  lease  mode  in  ms 

long  itemp  =  (long)  ge tNumNext Token (false) ; 
objectSP. setLease (itemp) ; 
currentProduction  =  20; 

}else  if  (stempl . compareTo (reserveWords [CLONE]  )  =  = 
//  clone  mode 

objectSP. setClone (definition. spaceTranslate 
(getNextToken (false)  )  )  ; 
currentProduction  =  20; 

}else  if  (stempl . compareTo (reserveWords [NOTIFY]  )  = 

0)  { 

//  notify  mode 

objectSP . setNotify (definition . spaceTranslate 
(getNextToken (false)  )  )  ; 
currentProduction  =  20; 

}else  { 

throw  new  automCodeGenException ( 

automCodeGenException . ParserSyntaxError)  ; 

} 

case  20:  stempl  =  new  String (getNextToken (false) ) ; 

if  (stempl . compareTo (reserveWords [PROPERTY] )  ==  0) 
currentProduction  =  10; 

}else  if  (stempl . compareTo (reserveWords [END]  )  ==  0 
//  End  of  IMPLEMENTATION 
return; 

}else  { 

throw  new  automCodeGenException ( 

automCodeGenException. ParserSyntaxError)  ; 

} 


} 

}//  end  of  while 
}//  end  of  method 

public  Vector  getDistObject ( ) { 
return  distObject; 

} 

}//  end  of  class 


APPBUILDER . JAVA 

// - 

//  Filename  :  appBuilder. java 
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//  Date  :  10  Jan  00 

//  Compiler  :  jdk  1.2  or  J++ 

// - 

package  psdl2 java .generator ; 

/** 

* 

*  ©author  Ngom  Cheng 

*  ©version  1.0 

*  appBuilder ,  generates  all  the  interface  wrapper 

*  codes . 

*/ 

import  java. util .Vector; 
import  java. util. Enumeration; 
import  java.io.*; 
import  java. util . StringTokenizer; 

//  psdl2java  classes 
import  psdl2 java. global.*; 
import  psdl2j ava. parser. *; 

public  class  appBuilder  extends  Object  { 

/** 

*  distObj ,  list  of  objects 
*/ 

private  Vector  distObj ; 

/** 

*  aicgToken [] ,  array  of  reserve  words 
*/ 

private  String  aicgToken []; 

/*  * 

*  aicgField[],  array  of  in  String  words 
*/ 

private  String  aicgField[]; 

/** 

*  sP,  space  properties 
*/ 

private  spaceProperties  sP; 
j  ★  * 

*  cDef,  main  class  definition 
*/ 

private  classDef inition  cDef; 
j  *  * 

*  destDir,  destination  directory 
*/ 

private  String  destDir; 
j  ★  * 

*  dataDir,  data  directory 
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*/ 

private  String  dataDir; 


/  ** 

*  checkAgai n,  retry  boolean 
*/ 

private  boolean  checkAgain  =  false; 

/  *  * 

*  static  constants  of  the  tokens 
*/ 

private  static  final  int  USEROBJECT  =0; 
private  static  final  int  USEREXT  =  1; 


private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 

private  static  final  int 
private  static  final  int 
private  static  final  int 

private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 
private  static  final  int 


USERENTRY  =2 ; 

USERCLIENT  =  3; 
USERSERVER  =  4; 

USEROBJID  =  5; 
USEROBJIDGETS  =  6; 

DATE  =  7; 

LOCALOBJNAME  =  8; 
SPACENAME  =  9; 
PACKAGENAME  =  10; 

LOCALS PACENAME  =  11; 

USERMETHOD  =  12; 

US  ERDE  CL ARAT I ON  =  13; 
USERPARAMETER  =  14; 

ENTRYDECLARATION  =  15; 
ENTRYASSIGN  =  16; 
EXTDECLARATION  =  17; 
AUTOGETID  =  18; 

AUTOSETID  =  19; 

EXTIDNULL  =  20; 
CLIENTCONSTRUCTOR  =  21; 

CL I ENTCON S TRUCT AS S 1  =  22; 
CL I ENT CON S TRUCTAS  S  2  =  23; 
CLIENTMETHOD  =24; 
SERVERCONSTRUCTOR  =25; 
SERVERMETHOD  =26; 

SETGETID  =27; 
USERPARAMETERWC  =28; 
EVENTGETID  =29; 
DISTOBJGETID  =  30; 


private  static 


final  char  DELIMITER  = 


I  *  * 

*  Constructor  Creates  new  appBuilder 
*/ 

public  appBuilder (psdlReader  pReader,  String  destDir, 
dataDir)  { 

// 

this.destDir  =  destDir; 
this. dataDir  =  dataDir; 

definition. DEFAULTPACKAGENAME  =  this.destDir; 

//  initialise  the  tokenfield 

aicgToken  =  new  String [definition .MAXTOKEN]  ; 


String 
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aicgField  =  new  String [definition . MAXTOKEN] ; 
aicgToken [USEROBJECT]  =  new  String ( " -userobj ect " ) ; 
aicgToken [USEREXT]  =  new  String ( " -userext ") ; 
aicgToken [USERENTRY]  =  new  String (" -userentry" ) ; 
aicgToken [USERCLIENT]  =  new  String ( " -userclient" ) ; 
aicgToken [USERSERVER]  =  new  String ( " -userserver" ) ; 
aicgToken [USEROBJID]  =  new  String (" -userobj id" ) ; 
aicgToken  [USEROBJIDGETS]  =  new  String (" -userobj idgets ") ; 
aicgToken [DATE]  =  new  String (" -date" ) ; 

aicgToken [LOCALOBJNAME]  =  new  String (" -localobjname" ) ; 
aicgToken  [SPACENAME]  =  new  String("-spacename"); 
aicgToken [PACKAGENAME]  =  new  String  ( "  -packagename" )  ; 
aicgToken [ LOCALS PACENAME]  =  new  String (" -localspacename" ) ; 

// 

aicgToken [USERDECLARATION]  =  new  String (" -userdeclaration" ) ; 
aicgToken [USERMETHOD]  =  new  String ( " -usermethod" ) ; 
aicgToken  [ENTRYDECLARATION]  =  new  String  (” -entrydeclaration'1 )  ; 
aicgToken [EXTDECLARATION]  =  new  String (" -extdeclaration" ) ; 
aicgToken [USERPARAMETER]  =  new  String ( " -userparameter ” ) ; 
aicgToken [USERPARAMETERWC]  =  new  String ( " -userparameterwc " ) ; 
aicgToken [USERDECLARATION]  =  new  String (" -userdeclaration" ) ; 
aicgToken [ENTRYASSIGN]  =  new  String (" -entryassign"  )  ; 
aicgToken [AUTOGETID]  =  new  String ( n -autogetid" ) ; 
aicgToken [AUTOSETID]  =  new  String("-autosetid"); 
aicgToken [EXTIDNULL]  =  new  String (" -ext idnull ") ; 
aicgToken [CLIENTCONSTRUCTOR]  =  new  String (" -clientconstructor ") ; 
aicgToken [CLIENTC0NSTRUCTASS1]  =  new  String ("- 
clientconstructassl" ) ; 

aicgToken [CLIENTC0NSTRUCTASS2]  =  new  String (" - 
clientconstructass2 " ) ; 

aicgToken  [CLIENTMETHOD]  =  new  StringC'-clientmethod"); 
aicgToken [SERVERMETHOD]  =  new  String (" -servermethod" ) ; 
aicgToken [SERVERCONSTRUCTOR]  =  new  String (" -serverconstructor ") ; 
aicgToken [SETGETID]  =  new  String(n-setgetidn); 
aicgToken [EVENTGETID]  =  new  String (" -eventgetid" ) ; 
aicgToken [DISTOBJGETID]  =  new  String (" -distobjgetid" ) ; 

// 

aicgField [LOCALOBJNAME]  =  new  String (" inObj ") ; 
aicgField [PACKAGENAME]  =  new 
String  (definition  .DEFAULTPACKAGENAME)  ; 

aicgField [DATE]  =  new  String (" 01/07/00 ") ; 

aicgField [SPACENAME]  =  new  String (definition .DEFAULTS PACENAME) ; 

/ /  create  the  package 
createPackage ( ) ; 

//  create  the  fixed  classes 
buildFixedClasses () ; 

//  get  the  distributed  objects  from  parser 
distobj  =  pReader . getDistObj ect () ; 

//  get  a  list  out 

Enumeration  enum  =  distObj . elements () ; 
while  (enum.hasMoreElements  0 ) { 

//  get  the  distributed  class  object 

cDef  =  (classDef inition)  enum. next Element () ; 

if  (cDef .getObjectState () ) { 


122 


//  it  a  aicg  object 
//  build  the  name 

aicgField [USEROBJECT]  =  new  String (cDef . getName ()) ; 
aicgField [USEREXT]  «  new  String (aicgField [0]  +  "Ext”); 
aicgField [USERENTRY]  =  new  String (aicgField [0]  +  "Entry"); 
aicgField [USERCLIENT]  =  new  String (aicgField [1]  +  "Client"); 
aicgField [USERSERVER]  =  new  String (aicgField [1]  +  "Server") ; 

//  get  the  space  properties 

sP  =  cDef . getProperties () ; 

aicgField [LOCALSPACENAME]  =  sP . getName ( ) ; 

//  process  the  information 
processDistObj () ; 

//  build  the  distributed  object 
buildDistObj () ; 

} 

}//  end  of  while 


} 


j  *  * 

*  createPackage,  create  a  directory  for  the  interface  wrapper 

*  ©return  void 
*/ 

public  void  createPackage () { 


//  create  the  files  for  that  application 
File  name  =  new  File (aicgField [PACKAGENAME] ) ; 


System. out .println ( "Phase  2 
if  (name . exists ( ) ) { 

System . out . println ( " 
System . out . println ( " 

}else  { 
try  { 

name.mkdir  ()  ; 

System. out .println ( " 
created" ) ; 

}catch  (Exception  e) { 
System . err . println ( " 

System. exit ( -1) ; 


:  Generating. . . " )  ; 

:  OutputDirectory  Exists"); 

:  No  new  directory  created  ") ; 

:  "  +  name . getName ( )  +  " 

:  Cannot  create  directory. . . 
exiting" ) ; 


} 

/** 

*  buildClass,  convert  the  template  data  into  interface  wrapper 

*  ©param  inName,  name  of  the  template 

*  ©param  outName,  name  of  the  output  file 

*  ©return  void 
*/ 

public  void  buildClass (String  inName,  String  outName) { 
PrintWriter  output; 

Buf feredReader  input; 

String  sTemp,  sTemp2; 
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StringTokenizer  sTokenizer; 

//  open  the  file  entryAICG. java. data 
try{ 

input  =  new  Buff eredReader (new  Fil eReader (inName) ) ; 
output  =  new  PrintWriter (new  Buff eredWriter (new 

FileWriter (aicgField [PACKAGENAME]  +  outName) ) ) ; 

try{ 

/ /  copy  the  input  to  a  temporary  String 

while  ((sTemp  =  input . readLine () )  !=  null) { 

sTemp  =  convert (sTemp) ; 
while  (checkAgain)  { 
checkAgain  =  false; 
sTemp  =  convert (sTemp) ; 

output. println (sTemp) ; 

}catch  (IOException  el) { 

System. err. println ( "Error  in  creating  "  +  inName); 
System. exit (1) ; 

} 

output .close ()  ; 
input . close ()  ; 

} catch  (IOException  e) { 

System. err. print In ("Error  in  creating  "  +  inName); 
System. exit (1) ; 


/  ★  * 

*  buildFixedClass ,  build  all  the  AICG  fixed  classes 

*  ©return  void 
*/ 

public  void  buildFixedClasses  ( ) { 

//  open  the  file  globalAICG. java. data 
buildClass(  dataDir  +  "WglobalAICG.  java,  data", 
"WglobalAICG.  java")  ; 

//  open  the  file  entryAICG. java. data 
buildClass (dataDir  +  n\\ entryAICG- java. data" , 

"WentryAICG.  java")  ; 

//  open  the  file  exceptionAICG . java . data 
buildClass (dataDir  +  " \\ exceptionAICG . j ava . data"  , 
"WexceptionAICG.  java")  ; 

//  open  the  file  eventAICGID. java. data 
buildClass (dataDir  +  "\\eventAICGID . java .data" , 

"  \ \ event AICG ID . j  ava " ) ; 

//  open  the  file  not if yAI CGID . java . data 
buildClass (dataDir  +  "\\notifyAICG. java .data" , 
"WnotifyAICG.  java")  ; 

//  open  the  file  spaceAICGID . java . data 
buildClass (dataDir  +  "\\spaceAICG . j ava . data" , 

" \ \ spaceAICG . j  ava " ) ; 

//  open  the  file  transact ionAICG . j ava . data 
buildClass (dataDir  +  " \\transact ionAICG . java . data" , 
"WtransactionAICG.  java")  ; 

//  open  the  file  spaceAICGID . java . data 

buildClass (dataDir  +  "WtransactionManagerAICG. java. data" , 
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WtransactionManagerAICG . j  ava" ) ; 


} 

I  *  * 

*  cleasAICGField,  reset  the  AICG  Fields 

*  @return  void 

*/ 

public  void  clearAICGField ( ) { 

aicgField [USERDECLARATION]  =  new  StringO; 
aicgField  [USEROBJID]  =  new  StringO; 
aicgField  [ENTRYDECLARATION]  =  new  StringO; 
aicgField [EXTDECLARATION]  =  new  StringO; 
aicgField  [USERPARAMETER]  =  new  StringO; 
aicgField  [ENTRYASSIGN]  =  new  StringO; 
aicgField  [AUTOGETID]  =  new  StringO; 
aicgField  [AUTOSETID]  =  new  StringO; 
aicgField [SETGETID]  =  new  StringO; 
aicgField  [EXTIDNULL]  =  new  StringO; 
aicgField [CLIENTCONSTRUCTASS1]  =  new  StringO; 
aicgField  [CLIENTCONSTRUCTASS2]  =  new  StringO; 
aicgField [USERPARAMETERWC]  =  new  StringO; 
aicgField  [EVENTGETID]  =  new  StringO; 

} 

f  ** 

*  processDistObj ,  gather  information  of  the  distributed  object 

*  for  use  in  creating  the  interface 

*  ©return  void 

*/ 

public  void  processDistObj () { 
variableDef inition  vD; 
methodDef ini t ion  mD; 

Enume  rat i on  enum ; 

Vector  iDs; 
int  counter  =  0; 

//  clear  the  aicgField  to  empty 

clearAICGField () ; 

iDs  =  cDef .get IDs () ; 

enum  =  iDs . elements ( ) ; 

while (enum. hasMoreElements ()  ) { 

vD  «  (variableDef inition)  enum. nextElement ( ) ; 
if  (counter  ==0) { 

aicgField [USERDECLARATION]  =  new  String ( "private  "  + 
vD.getJavaObject  ()  +  "  "  +  vD.getIDO  +  ";\n"); 
aicgField [USEROBJID]  =  new 
String (vD .getClassID () .getAICGName () 

+  "  ,  " )  ; 

aicgField [ENTRYDECLARATION]  =  new  String ( "public  "  + 
vD . get JavaOb j  ect ( )  + 

"  "  +  vD.getClassID () .getAICGName ()  +  ";\n"); 

aicgField [EXTDECLARATION]  =  new  String ( "protected  "  + 
vD.getJavaObject ()  +  "  "  + 
vD . getClassID ( ) . getAICGName ( )  +  " ; \n" ) ; 
aicgField [USERPARAMETER]  =  new  String (vD . get JavaOb j ect ( )  + 

"  "  +  vD .getClassID (). getAICGName ()) ; 
aicgField [USERPARAMETERWC]  =  new  String (vD . get JavaOb j ect ( )  + 
"  "  +  vD.getClassID () .getAICGName ()  +  ",  "); 
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aicgField [ENTRYASSIGN]  =  new  String ( "this . "  + 
vD.getClassID () .getAICGName  ()  +  "  =  "  + 
vD . getClassID ( ) . getAICGName ( )  +  »;\n"); 
aicgField [AUTOGETID]  =  new  String ( "public  synchronized  " 
+vD.getJavaObject ()  +  1  '  +  "get"  + 
vD.getClassID () .getAICGName ()  +  »()\n"  + 

"  {\n  return  "  +  vD.getClassID () .getAICGName () 

+ 

";\n  }\n") ; 

aicgField [DISTOBJGETID]  =  new  String ( "public  synchronized  " 
+vD.getJavaObject ()  +  ’  '  +  "get"  + 
vD.getClassID () .getAICGName ()  +  "()\n"  + 

"  {\n  return  "  +  vD.getIDO  +  ";\n  }\n")  ; 

aicgField [AUTOSETID]  =  new  String ( "public  synchronized  void  " 

+ 

"set"  +  vD.getClassID () .getAICGName ()  +  "(  »  + 
vD.getJavaObject ()  +  "  inID) \n"  +  »  {\n  "  + 

vD.getClassID () .getAICGName ()  +  "  =  inID;\n  }\n") ; 
aicgField [SETGETID]  =  new  String ("  set"  + 

vD.getClassID () .getAICGName ()  +  " (ddata.get"  + 
vD.getClassID () .getAICGName ()  +  "());\n»); 
aicgField [EXTIDNULL]  =  new 

String (vD . getClassID ( ) . getAICGName ( ) 

+  "  =  null;\n"); 

aicgField [CLIENTC0NSTRUCTASS1]  =  new  String ("  «  + 

vD . get JavaObj ect ( )  +  '  ’  +  "temp"  + 
vD.getClassID () .getAICGName ()  +  "  =  "  + 
vD.getClassID () .getAICGName ()  +  "  ;\n") ; 
aicgField [CLIENTCONSTRUCTASS2]  =  new  String (",  temp"  + 
vD.getClassID () .getAICGName () ) ; 
aicgField [EVENTGETID]  =  new  String ( "indata .get"  + 
vD.getClassID () .getAICGName ()  +  " () ,  "); 


}else  { 

aicgField [USERDECLARATION]  =  new 

String (aicgField  [USERDECLARATION]  + 

"  private  "  +  vD.getJavaObject  ()  +  "  "  + 

vD.getIDO 

+  ";\n") ; 

aicgField [USEROBJID]  =  new  String (aicgField [USEROBJID] 
+  vD.getClassID () .getAICGName ()  +  ",  ") ; 
aicgField [ENTRYDECLARATION]  =  new 

String (aicgField [ENTRYDECLARATION]  + 

"  public  "  +  vD.getJavaObject ()  + 

"  "  +  vD. getClassID () .getAICGName ()  +  ";\n"); 
aicgField [EXTDECLARATION]  =  new 
String (aicgField [EXTDECLARATION] 

+  "  protected  "  +  vD.getJavaObject ()  + 

"  "  +  vD.getClassID () .getAICGName ()  +  ";\n"); 
aicgField [USERPARAMETER]  =  new 
String (aicgField [USERPARAMETER]  + 

",  "  +  vD.getJavaObject ()  + 

"  "  +  vD.getClassID () .getAICGName ()) ; 
aicgField [USERPARAMETERWC]  =  new 

String (aicgField  [USERPARAMETERWC] 

+  vD.getJavaObject ()  + 

"  "  +  vD.getClassID () .getAICGName ()  +  ",  »)  ; 
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aicgField [ENTRYASSIGN]  =  new  String (aicgField  [ENTRYASSIGN]  + 

"  this."  +  vD.getClassID () .getAICGName ()  + 

"  =  "  +  vD .getClass ID () .getAICGName ()  +  ";\n"); 
aicgField [AUTOGETID]  =  new  String (aicgField [AUTOGETID]  + 

"  public  synchronized  "  +vD.getJavaObject ()  +  1  ' 

"get"  +  vD.getClassID  ()  .getAICGName  ()  +  "0\n"  + 

"  {\n  return  "  +  vD.getClassID () . getAICGName ( )  + 

";\n  } \n" ) ; 

aicgField [DISTOBJGETID]  =  new  String (aicgField [DISTOBJGETID]  + 
"public  synchronized  "  +vD.getJavaObject ()  +  '  '  + 

"get"  +  vD.getClassID  ()  .getAICGName  ()  +  "0\n"  + 

"  {\n  return  "  +  vD.getIDO  +  ";\n  }\n") ; 

aicgField [AUTOSETID]  =  new  String (aicgField [AUTOSETID]  + 

"  public  synchronized  void  "  +  "set"  + 
vD.getClassID () .getAICGName ()  +"("+ 
vD.getJavaObject ()  +  "  inID) \n"  + 

"  {\n  "  +  vD.getClassID () .getAICGName ()  +  "  = 

inID; \n  }\n"); 

aicgField [SETGETID]  =  new  String (aicgField [SETGETID]  + 

"  set"  +  vD. getClass ID () .getAICGName ()  + 
"(ddata.get"  +  vD.getClassID () .getAICGName ()  + 

" 0 ) ;\n") ; 

aicgField [EXTIDNULL]  =  new  String (aicgField [EXTIDNULL]  + 

"  "  +  vD.getClassID () .getAICGName ()  +  "  = 

null; \n") ; 

aicgField [CLIENTCONSTRUCTASS1]  =  new  String ( 

aicgField [CLIENTC0NSTRUCTASS1]  +  "  "  + 

vD . get JavaOb j ect ( )  +  '  '  +  "temp"  + 

vD.getClassID () .getAICGName ()  +  "  =  "  + 

vD.getClassID () .getAICGName ()  +  "  ;\n"); 
aicgField [CLIENTCONSTRUCTASS2]  =  new 

String (aicgField [CLIENTC0NSTRUCTASS2]  + 

",  temp"  +  vD.getClassID () .getAICGName () ) ; 
aicgField [EVENTGETID]  =  new  String (aicgField [EVENTGETID]  + 

"indata. get"  +  vD.getClassID () .getAICGName ()  +  " () , 

} 

counter  ++; 

}  //end  of  while 

//  process  the  methods 
iDs  =  cDef .getMethods () ; 
enum=  iDs . elements ( ) ; 

aicgField [CLIENTMETHOD]  =  new  String!); 
aicgField [SERVERMETHOD]  =  new  String (); 

String  withcomma; 
counter  =  0 ; 

while (enum.hasMoreElements () ) { 

mD  =  (methodDef inition)  enum.nextElement ()  ; 

//  constructor  for  client 

if  (mD.getReadProperty {)  ==  definition. SPCONSTRUCTOR) { 
aicgField [CLIENTCONSTRUCTOR]  =  new  String ( "public  "  + 

mD . getRetType ( )  +  "  "  +  aicgField [USERCLIENT]  +  ” (  " 

+  aicgField [USERPARAMETER]  + 

”)  throws  exceptionAICG{\nn  +  "  super!)  An"  + 
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object\n" 


"  int  retry  =  globalAICG. AICGDEFAULTRETRY; \n"  + 

"  boolean  trxSucc  =false;\n''  + 

"aicgField [CLIENTC0NSTRUCTASS1]  + 

"  while  (retry  !=0){\n"  +  "  try{\n"  + 

"  //  create  atemplate  to  seach  for  the 

+  "  "  +  aicgField [USERENTRY]  + 

"  template  =  new  "  +  aicgField [USERENTRY]  + 

"  (globalAICG. AICGIDENTIFIER  "  + 
aicgField [CLIENTC0NSTRUCTASS2]  + 

",  null) ;\n"  + 

"  distObj  =  ("  +  aicgField [USERENTRY]  + 

")  space. read (template, null, \n"  + 

"  globalAICG. AICGDEFAULTWAITTIME ) ;\n"  + 

"  "  +  aicgField [USEROBJECT]  +  "  ddata  =  ("  + 

aicgField [USEROBJECT]  + 

" )  distObj . getOb j ect ( ) ; \n”  + 

"  "  +  aicgField [SETGETID]  + 

"  retry  =  0;\n"  + 

"  trxSucc  =  true;\n"  + 

"  } catch  (Exception  e) {\n"  + 

"  System. err .println (\ "retrying  to  find 

object\") ;\n"  + 

"  retry-- ;\n"  + 

"  }\n"  + 

"  }//  end  of  while\n"  + 

"  if  (! trxSucc) { \n"  + 

"  throw  new  except ionAICG 

(exceptionAICG.ObjectNotFoundException) ;\n"  + 

"  }  \n"  + 

"  }\n"  ) ; 


//server  constructor 

aicgField [SERVERCONSTRUCTOR]  =  new  String ( "public  "  + 
mD . getRetType ( )  +  "  "  + 

aicgField [USERSERVER]  + 

"(  "  +  mD.getParameterStringO  + 

")  throws  exceptionAICG{\n"  + 

"  super () ;\n"  + 

"  //  create  the  template  \n"  + 

"  Transaction  trn  =  null,-\n"  + 

"  try  {\n"  + 

"  trn  =  trnMgr . getDef aultTransaction ( ) ; \n"  + 

"  try { \n"  + 

"  "  +  aicgField [USEROBJECT]  +  "  ddata  =  new 

"  + 

aicgField [USEROBJECT]  +  * ( •  + 
mD.getParameterName ()  +  ");\n"  + 

"  "  +  aicgField [SETGETID]  + 

"  "  +  aicgField [USERENTRY]  +"  template  =  new 

"  + 

aicgField [USERENTRY]  + 

" (globalAICG. AICGIDENTIFIER,  "  + 

aicgField [USEROBJID]  +  "null);\n" 

+ 

"  //check  if  the  distobj  exit\n"  + 

"  if  (space . read (template,  trn, 
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JavaSpace .NO_WAIT)  ==  null) {\n"  + 

«  distObj  =  new  "  +  aicgField [USERENTRY]  + 

M (globalAICG .AICGIDENTIFIER,  "  + 
aicgField [USEROBJID]  +  "ddata) ; \n”  + 

11  ,  space .write (distObj ,  trn, 

globalAICG. AICGLEASETIME) ;\n"  + 

"  trn. commit () ;\n"  + 

"  }else{  \n"  + 

”  //  throws  an  except ion\n"  + 

"  trn. abort () ;\n"  + 

"  throw  new 

exceptionAICG ( 

exceptionAICG . Ob j  ectExistException) ;\nM  + 

"  }\n"  + 

"  }catch  (exceptionAICG  e) {\n”  + 

”  trn. abort () ;\n"  + 

n  throw  new 

except ionAICG ( e. getErrorCode () ) ;\n"+ 

”  }catch  (Exception  e)  {\nn  + 

"  trn. abort (); \n"  + 

”  e . printStackTrace ( )  ;  \n"  + 

"  throw  new  exceptionAICG ( 

exceptionAICG. SystemExceptionCode) ;\nM  + 

"  }\nn  + 

M  } catch  (exceptionAICG  e)  {\nu  + 

H  throw  new  exceptionAICG (e . getErrorCode ()); \nM 

+ 

H  }catch  (Exception  e)  {\nn  + 

"  throw  new  exceptionAICG ( 

exceptionAICG. SystemExceptionCode) ;\n"  + 

"  }\n"  + 

"  }\n”) ; 


+ 


null. 


+ 


}else  if  (mD . getReadProperty ( )  ==  definition. SPREAD) { 
aicgField  [CLIENTMETHOD]  =  new  String (aicgField [CLIENTMETHOD] 

"  public  M  +  mD.getRetType ()  +  M  "  + 
mD.getNameO  +  "  (  "  + 
mD.getParameterString  ()  +  11 )  throws 
exceptionAICG  {\n"  + 

"  "  +  aicgField [USERENTRY]  +  " 

msgTemplate  =  new  ”  + 
aicgField [USERENTRY]  + 

11  (globalAICG.  AICGIDENTIFIER,  "  + 

aicgField [USEROBJID]  +  "null) ; \n\n"  + 
"  try{\n"  + 

"  distObj  =  ("  + 

aicgField [USERENTRY]  +  ")\n"  + 

"  space . read (msgTemplate, 

globalAICG. AICGDE FAULTWAITTIME) ;\n"  + 
"  if  (distObj ==null) {\nn  + 

"  //  object  nolonger  exist  \n" 

"  throw  new  exceptionAICG ( 
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except ionAICG . Ob j  ectNotFoundException) ; \n" 
+  "  }\n"  + 

"  return  distObj . data . "  + 

mD.getNameO  +  ’('  +  mD.  getParameterName  ( ) 
+  ");\n"  + 

"  jcatch  (except ionAICG  ex) {\n"  + 

"  throw  new  exceptionAICG ( 

except ionAICG . Ob j  ectNotFoundException)  ;  \n" 
+  "  } catch  (Exception  e)  {\n  "  + 

"  throw  new  exceptionAICG ( 

exceptionAICG. SystemExceptionCode) ;\n"  + 

"  }\n"  + 

"  }\n\n" ) ; 

}else  { 

aicgField [SERVERMETHOD]  =  new  String (aicgField [SERVERMETHOD] 

"  public  "  +  mD .  getRetType  ( )  +  •'  »  + 

mD.getNameO  +  "(  "  + 
mD.getParameterStringO  +  ")  throws 
exceptionAICG  {\n"  + 

"  int  retry  = 

globalAICG . AICGDEFAULTRETRY ; \n"  + 

"  boolean  trxSucc  =false,-\n"  + 

"  "  +  aicgField [USERENTRY]  +  " 

msgTemplate  =\n"  + 

"  new  "  +  aicgField [USERENTRY] 

" (globalAICG. AICGIDENTIFIER,  "  + 

aicgField [USEROBJID]  +  "null) ;\n"  + 

"  Transaction  trn  =  null;\n\n"  + 

"  while(retry  !=0) {\n"  + 

"  try  {\n"  + 

"  trn  =  trnMgr.createTransaction 

(globalAICG.USERTXNLEASE) ;\n"  + 

"  try {\n"  + 

"  distObj  =  ("  + 

aicgField [USERENTRY]  +  ")\n"  + 

"  space . take (msgTemplate , 


method\n"  + 
mD.getNameO  + 


Long . MAX_VALUE ) ; \ n "  + 

"  //  called  the  actual 

"  distObj .data. "  + 

'('  +  mD. getParameterName ()  +  ") ;\n"  + 

"  space. write  (distObj, 

trn, globalAICG.  AICGLEASETIME) ;\n"  + 
"  trn. commit () ;\n"  + 

"  retry  =  0;\n"  + 

"  trxSucc  =  true; \n"  + 

"  }catch  (Exception  e) {\n"  + 

"  trn. abort () ;\n"  + 

"  retry  --;\n"  + 


System. err .println (\ "Exception 

level  1:  retrying\" ) ; \n"  + 
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11  }  \n"  + 

"  }catch  (Exception  e)  {\n”  + 

"  retry- -;\n"  + 

11  System .  err .  print  In  ( \ "  Exception 

level  2:  retrying\n) ;\n"  + 

11  }\n"  + 

"  }//  end  of  while\n"  + 

"  if  ( ! trxSucc) {\n"  + 

"  throw  new  exceptionAICG 

( except ionAICG . SystemExceptionCode) ; 
\n"  +  "  } \nM  +  "  }\n") ; 

} 

//  others 
if  (counter  ==0) { 

aicgField [USERMETHOD]  =  new  String ( "public  "  + 
mD.getRetType ()  + 

"  "  +  mD .  getName  ( )  +  11  (  "  + 

mD . getParameterString ( )  +  " ) "  + 

"  {\n\n\n  }\n\n"  ); 


} 


}else  { 
aicgField 


} 


[USERMETHOD]  =  new  String (aicgField  [USERMETHOD] 
”  public  M  +  mD.getRetType  ()  +  11 
mD . getName ( )  +  " (  "  + 
mD. getParameterString ()  +  ")  "  + 

"  {\n\n\n  }\n\nn  ); 


counter  ++; 


+ 

"  + 


} 

/** 

*  buildDistObj ,  build  the  rest  of  the  interface  wrappers 

*  @return  void 
*/ 

public  void  buildDistObj () { 

PrintWriter  output; 

BufferedReader  input; 

String  sTemp ,  sTemp2 ; 

StringTokenizer  sTokenizer; 

//  build  the  distributed  object 
buildClass (dataDir  +  "\\distobj .java. data", 

"\\"  +  aicgField [USEROBJECT]  +  ".java"); 
//  build  the  Entry  object 

buildClass (dataDir  +  "\\distobjentry. java. data", 

"\\"  +  aicgField [USERENTRY]  +  ".java"); 
//  build  the  Ext  object 

buildClass (dataDir  +  " \\distob j ext. java. data" , 

"\\"  +  aicgField [USEREXT]  +  " .java"); 

//  build  the  ExtClient  object 
buildClass (dataDir  +  "\\distobjextclient . java .data" , 

"\\"  +  aicgField  [USERCLIENT]  +  ".java"); 
//  build  the  ExtServer  object 
buildClass (dataDir  +  "\\distobjextserver. java. data". 
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"\\"  +  aicgField [USERSERVER]  +  ".java"); 

//  build  the  eventAICGHandler  object 
buildClass  (dataDir  +  "WeventAICGHandler .  java. data"  , 

"  \  \  e vent AI  CGHandl  e  r .  j  a va  " )  ; 

System . out . pr int In ( "  :  Interface  Generating  Completed"); 


/** 

*  convert,  parse  the  template  statement  into  codes 

*  @param  inString,  template  statement 

*  @return  String,  output  statement 
*/ 

public  String  convert (String  inString) { 

int  len  =  0; 
int  endLen  =  0; 
char  cTemp; 

String  sTemp; 

String  retString  =  new  String  (inString) ; 
try{ 

while  (len  <  retString . length ()) { 

if  (retString. charAt (len)  ==  DELIMITER) { 
if  (inString. charAt (len  +  1)  ==  '-’){ 
len  =  len  +  1; 
endLen  =  len  +  1; 

while (  retString. charAt (endLen)  !=  DELIMITER) { 
endLen  ++; 

}  . 

sTemp  =  new  String (  retString . substring (len, endLen) ) ; 

sTemp  =  replace (sTemp) ; 

if  (endLen  <  retString . length () -1) { 

retString  =  new  String (retString . substring ( 0 ,  len-1)  + 
sTemp  +  retString. substring (endLen  +  1, 
retString . length ( ) ) ) ; 

}else  { 

retString  =new  String (retString . substring (0 ,  len-1) 

+  sTemp  ) ; 

checkAgain  =  true; 
return  retString; 

}  } 

len++; 

} 

}catch  (Exception  e) { 

System. err. println ("out  of  Bound  error") ; 

System. exit (1) ; 

} 

return  retString; 


j  ** 
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*  replace,  check  and  replace  the  token  with  the  respective  string 

*  ©param  inString,  token 

*  ©return  String,  output  codes  for  the  token 
*/ 

public  String  replace (String  inString) { 

for  (int  i  =  0;  i<  def inition.MAXFIX;  i++)  { 
if  (inString. compareTo (aicgToken [i] )  ==0) { 

return  aicgField [i] ; 


System. err .println ( "Token  not  found  "  +  inString  ); 
System. exit (-1)  ; 
return  inString; 

} 


} 


THIS  PAGE  IS  INTENTIONALLY  LEFT  BLANK 
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APPENDIX  D.  SETTING  UP  THE  JAVASPACE  ENVIRONMENT 


EXTRACTED  FROM  THE  NUTS  AND  BOLTS  OF  COMPILING  AND  RUNNING 
JAVASPACES  PROGRAMS  BY  SUSANNE  HUPFER 

Downloading  the  Software  Packages 

Compiling  and  running  JavaSpaces  programs  requires  the 
installation  of  three  separate  packages  from  Sun 
Microsystems- -Java,  Jini,  and  JavaSpaces  software. 

•  If  you  don't  already  have  the  Java™  2  SDK,  Standard 
Edition,  v  1.2.x  installed  on  your  machine,  download  it 
from  Sun 1 s  Java  2  SDK 

<  ht  t p : / / www . j  ava . sun . com/products / j  dk/ 1 . 2 / > .  The  Jini 
and  JavaSpaces  software  require  version  1.2.x  of  the 
Java  Development  Kit,  because  they  make  use  of  RMI 
features  that  are  not  available  in  version  1.1  of  the 
JDK. 

•  Next  you'll  need  to  download  the  Jini™  Technology 
Starter  Kit,  Version  1.0.1,  from  the  Jini  System 
Software  1.0  Product  Offerings 

<http : / /developer . j  ava . sun . com/ developer/product s/ j ini / 
product . offerings . html> .  (Note  that,  as  this  article  is 
being  written,  Version  1.0.1  is  the  latest  release,  and 
you'll  therefore  see  the  number  "1.0.1"  appearing  in 
the  commands;  if  there  is  a  newer  release  when  you  read 
this  article,  you  should  substitute  the  newer  version 
numbers  as  appropriate.)  You'll  have  to  click  on  the 
link  "Register  and  accept  the  SCSL  to  access  software 
downloads"  and  step  through  a  free  registration  process 
in  order  to  download  the  kit.  The  file  you  download  is 
called  jinii_o_i.zip.  The  Jini  Technology  Starter  Kit 
contains  Jini  interfaces  and  classes,  along  with  a 
number  of  services.  It  also  contains  the  complete  set 
of  Sun  Microsystems  Jini  specifications,  documentation, 
and  example  code. 

•  Last,  download  the  JavaSpaces™  Technology  Kit  (JSTK) , 
Version  1.0.1,  from  the  Jini  System  Software  1.0 
Product  Offerings 

<http : / /developer . j  ava . sun . com/developer/products/ j ini / 
product . offerings . html > .  Again,  you'll  need  to  click  on 
the  link  "Register  and  accept  the  SCSL  to  access 


software  downloads."  The  file  you  download  is  called 
jstki_o_i.zip;  it  contains  the  Sun  Microsystems 
implementation  of  the  JavaSpaces  technology,  along  with 
documentation  and  example  code. 

Installing  the  Packages 

•  Now  that  you've  downloaded  the  three  necessary  software 
packages,  you're  ready  to  unpack  and  install  them. 
First,  if  you  don't  already  have  Java™  2  SDK™  version 
1.2.x  installed,  follow  the  installation  instructions 
that  come  with  the  package  to  install  it  on  your 
platform.  This  article  assumes  that  Java  software  is 
installed  in  C:\jdki. 2. x\  on  Windows  platforms  and 
/ j dki .2.x/  on  Solaris  platforms. 

•  Next,  you  need  to  install  the  Jini  Technology  Starter 
Kit  and  then  the  JavaSpaces  Technology  Kit  (JSTK) .  Note 
that  the  current  packaging  of  the  JSTK  requires  that 
the  Jini  software  be  installed  first,  because  the 
software  packages  build  upon  one  another;  if  this  order 
is  not  followed,  the  installation  and  API  documentation 
will  not  be  correct.  Here  are  the  steps  in  the  correct 
order : 

•  Extract  the  files  in  jinii_o_i.zip  to  your  chosen 
destination  directory,  using  a  ZIP  extraction  utility. 
For  example,  on  the  Windows  platform,  use  a  utility 
such  as  WinZip  and  specify  that  the  software 
distribution  should  extract  to  a  certain  destination 
directory.  If  you  specify  C:\  as  the  destination,  you 
should  now  have  a  folder  C:\jinii_0_1  that  contains  the 
Jini  files.  On  the  Solaris  platform,  copy  the  file 
jinii_o_i.zip  to  a  destination  directory,  cd  to  that 
directory,  and  then  use  a  ZIP  extraction  program,  for 
example  jar  -xvf  jinii_o_i.zip.  This  document  assumes  that 
Jini  software  resides  in  C:\jini1_0_1  \  on  Windows 
platforms  and  /jinii_o_i/  on  Solaris  platforms. 


•  Extract  the  files  in  jstki_0_1.zip  to  the  same 
destination  directory.  This  results  in  some  files  being 
overwritten,  so  when  asked  whether  you  wish  to  replace 
any  of  the  existing  files,  answer  "yes". 
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Configuring  Your  Machine  Environment 

Now  that  you  have  unpacked  the  software,  you  still  need  to 
do  some  configuration.  The  file  C:\jinil_o_l\index.html 
(/ j ini i_o_i/ index.html  on  Solaris)  contains  pointers  to  release 
notes  and  other  documentation  (much  of  which  is  found  in  the 
doc  folder) .  You  may  want  to  read  over  the  release  notes  for 
any  information  not  covered  in  this  document;  in  particular, 
the  sections  covering  "Known  Bugs"  or  "Known  Issues"  can  be 
a  useful  starting  point  if  you're  experiencing  a  problem. 

Make  sure  that  the  path  to  the  basic  tools  provided  by  the 
Java  Development  Kit  (for  example,  java,  javac,  and 
appletviewer)  is  specified  in  your  executable  path.  For 
instance,  on  Windows  platforms,  you  need  to  set  the  path 
environment  variable  as  follows: 
set  PATH=%PATH% ; C : \ j dkl . 2 . x\bin ; 


As  for  your  classpath  environment  variable,  we  recommend  that 
you  do  not  modify  it.  To  run  the  standard  run-time  Jini 
services  (see  Starting  the  Required  Run-time  Services)  ,  no 
special  classpath  is  needed.  When  you  build  and  run  your  own 
JavaSpaces  code,  we  recommend  passing  the  required  JAR  files 
on  the  command  line,  rather  than  modifying  the  classpath  or 
placing  JAR  files  in  the  Java  extensions  directory  (we'll 
explain  further  in  Compiling  JavaSpaces  Programs) . 


Starting  the  Required  Run-time  Services 

JavaSpaces  applications  interact  with  one  or  more  spaces,  so 
to  run  a  JavaSpaces  application  you'll  need  to  have  at  least 
one  JavaSpaces  service  running.  But  this  itself  depends  on 
having  a  Jini  infrastructure  in  place,  and  before  you  start 
a  JavaSpaces  service,  you  need  to  start  these  other  run-time 
services : 

•  An  HTTP  server,  which  is  used  to  download  code  to 
JavaSpaces  clients. 

•  An  RMI  Activation  Daemon,  which  takes  care  of  managing 
the  states  of  services,  for  instance  restarting  crashed 
services,  or  deactivating  and  reactivating  services 
based  on  whether  they're  being  used  or  not  (these 
responsibilities  are  described  in  more  detail  below) . 
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•  A  Lookup  Service,  which  allows  clients  to  look  up  and 
find  the  Jini  services  that  are  currently  available  on 
the  local  network. 

•  A  Transaction  Manager,  which  is  needed  if  your 
JavaSpaces  applications  make  use  of  transactions. 

Once  these  services  are  up  and  running,  you  can  start: 

•  A  JavaSpaces  Service. 

When  building  and  testing  JavaSpaces  applications,  you'll 
most  likely  run  these  services  and  your  JavaSpaces  client 
programs  on  a  single  desktop  machine,  but  when  deploying 
your  final  code,  you'll  most  likely  run  them  in  a 
multimachine  environment.  So,  let's  step  through  the  details 
of  starting  each  of  these  services,  paying  attention  along 
the  way  to  avoiding  pitfalls  that  could  occur  as  you  move 
your  code  from  testing  into  deployment. 


Starting  an  HTTP  Server 

Web  servers  are  used  for  delivering  class  code  to  Jini 
clients.  Let's  take  a  brief  look  at  how  this  works. 

Whenever  you  run  a  JavaSpaces  application  that  needs  to 
serve  classes  to  clients  (for  example,  one  that  writes 
entries  into  a  JavaSpace)  ,  you  need  to  include 
"codebase"  information  on  the  command  line  (as  you'll 
see  in  Running  JavaSpaces  Programs) .  The  codebase 
specifies  locations- -usually  URLs- -from  which  a  client 
can  download  the  class  files.  Whenever  your  code  writes 
entry  objects  into  the  space,  the  entries  get  annotated 
with  that  information.  When  a  client  of  the  space  later 
removes  or  reads  an  entry  object  from  the  space,  the 
entry's  codebase  annotation  tells  the  client  where  to 
look  for  the  class  code,  which  is  downloaded  from  an 
HTTP  server  (if  the  class  doesn't  already  exist  in  the 
classpath)  .  Typically  you'll  run  a  web  server  on  each 
machine  that  needs  to  export  code. 

Any  web  server  that's  capable  of  serving  documents  can 
do  the  job,  but  for  convenience,  the  Jini  distribution 
provides  a  simple  HTTP  server  in  the  tools. jar  package. 
Here  is  the  command  to  start  the  supplied  HTTP  server 
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(where  optional  parameters  are  shown  in  square 
brackets) : 

java  -jar  C:\jinil_0_l\lib\tools.jar 
[-port  port -number] 

[-dir  document -root -dir] 

[-verbose] 

For  example,  on  the  Windows  platform,  you  might  issue 
this  command: 

java  -jar  C:\jinil_0_l\lib\tools.jar 
-port  8081 

-dir  C:\jinil_0_l\lib 
-verbose 

On  Solaris,  the  equivalent  command  is: 

java  -jar  / j inil_0_l/lib/tools . jar 
-port  8081 
-dir  / j inil_0_l/lib 
-verbose 

The  JAR  file  containing  the  HTTP  Server  is 
C:\jinil_0_1\lib\tools.jar;  this  is  an  "executable  JAR" 
file  (introduced  in  the  Java  2  platform)  ,  which  means 
that  it  starts  a  default  program  (in  this  case,  the 
HTTP  server)  when  it's  invoked  as  shown. 

Here,  you  started  the  HTTP  Server  at  port  8081  (if  left 
unspecified,  the  port  number  would  be  8080)  .  The  -dir 
option  specifies  which  directory  the  server  uses  as  its 
"document  root."  Here,  you  specified  the  Jini  lib 
directory  as  the  root,  so  this  HTTP  server  is  able  to 
serve  all  the  Jini  JAR  files  in  that  directory  (as  well 
as  other  classes  you  might  put  there)  .  The  -verbose 
option  causes  information  to  be  displayed  about  each 
request  to  the  server,  and  is  useful  for  debugging 
purposes . 

Starting  an  RMI  Activation  Daemon 

An  RMI  Activation  Daemon  is  needed  by  several  other 
services- -the  Transaction  Manager,  the  persistent 
JavaSpaces  Service,  and  the  Jini  Lookup  Service- -and  an 
instance  of  the  daemon  needs  to  be  run  on  each  of  the 
machines  where  you  run  these  services .  What  does  an 
activation  daemon  do?  Suppose  you  have  a  service  that 
you'd  like  to  be  automatically  restarted  if  it  crashes 
(for  instance,  if  the  machine  it  is  running  on 
crashes).  Or,  suppose  you're  interested  in  conserving 
computational  resources,  so  you'd  like  a  service  to  be 
brought  down  when  it  has  no  active  clients  and 
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reactivated  later  when  a  client  tries  to  use  the 
service.  An  activation  daemon  takes  care  of  restarting, 
deactivating,  and  reactivating  your  services  (such  as 
the  Jini  services  mentioned  above) . 

Let's  see  how  to  start  an  RMI  activation  daemon.  First, 
be  sure  your  executable  path  points  to  the  bin 
directory  of  JDK1.2.2;  this  is  where  rmid  is  located. 
Again,  make  sure  that  you  haven't  modified  your 
classpath  environment  variable  or  placed  JAR  files  in 
the  Java  extensions  directory. 

Then,  to  start  rmid  under  Windows  or  Solaris,  the 
command  takes  the  form: 

rmid  [-port  port -number]  [-log  dir] 

For  example,  to  start  the  RMI  Activation  Daemon  on 
either  Windows  or  Solaris,  you  could  use  the  command: 
rmid 

to  start  the  daemon  on  the  default  port  of  1098.  For 
further  information  on  starting  rmid,  refer  to  the 
manual  pages  for  Solaris 

<http :  /  /  j  ava . sun . com/products/ j  dk/1 . 2 /docs/tooldocs/sol 
aris/rmid.html> 

or  Windows 

<http : // j ava . sun. com/products/ j  dk/1 . 2/docs/tooldocs/win 
32/rmid.html>~ 


Starting  a  Lookup  Service 

A  lookup  service  registers  the  Jini  services  available 
on  the  local  network,  and  is  used  by  applications  to 
locate  services  such  as  a  JavaSpace .  You  can  currently 
choose  to  use  either  the  RMI  registry  or  the  Jini 
lookup  service  to  serve  this  purpose,  but  you  should  be 
aware  that  future  versions  of  Jini  services  may  not 
support  the  use  of  the  RMI  registry.  Therefore,  this 
document  only  covers  using  the  Jini  lookup  service  (if 
you  really  want  to  use  the  RMI  registry,  you  can  find 
the  details  in  C:\jinil_O_l\doc\example\StartingService.html)  . 

The  command  to  start  the  Jini  lookup  service  takes  this 
form: 

java  -Djava. security . pol icy = security -policy- file 


140 


-jar  C:\jinil_0_l\lib\reggie.jar 
lookup-codebase 
security-policy-file 
log-direc tory 
[ 1 ookup - group ] 

Let ' s  examine  each  of  the  parameters . 

The  -Djava.  security. policy  option  to  java  specifies  a  "security 
policy  file"  for  the  JVM  to  use  when  it  runs  the  lookup 
service  JAR  file.  The  concept  of  a  security  policy  file  is 
new  in  the  Java  2  platform;  it  is  used  to  specify  what 
resources  a  program  can  use  when  it  runs- -for  example, 
whether  it  is  permitted  to  access  system  properties,  create 
and  listen  to  socket  connections,  write  to  log  files,  and  so 
on- -and  what  level  of  privileges  to  grant  to  any  downloaded 
code . 

The  JAR  file  containing  Sun's  implementation  of  the 
lookup  service  (called  "reggie")  is 

C:\jinii_o_i\lib\reggie.jar.  Once  again,  this  is  an 
executable  JAR  file,  which  means  it  will  start  running 
(in  a  "setup  JVM")  when  it's  invoked  as  shown.  First 
the  remaining  parameters  are  parsed,  then  the  reggie 
lookup  service  is  registered  with  the  RMI  Activation 
Daemon  you  started  earlier  on  the  same  machine,  and 
then  the  setup  JVM  exits  (don't  be  alarmed  that  your 
command  returns  at  this  point,  and  that  your  DOS 
window,  under  Windows,  says  "Finished").  The  lookup 
service  is  activatable :  It  will  be  restarted 
automatically  by  the  activation  daemon  after  crashes, 
and  it  will  shift  between  "active"  and  "inactive" 
states  as  appropriate.  In  this  case,  the  activation 
daemon  spawns  a  new  "server  JVM"  to  run  the  lookup 
service;  in  fact,  whenever  a  lookup  service  is 
activated,  a  new  "server  JVM"  is  spawned  to  run  that 
instance  of  the  service. 

The  final  four  parameters  deserve  a  closer  look.  The 
lookup-codebase  option  specifies  a  URL  that  points  to  the 
reggie -dl .jar  file,  which  contains  the  code  that  clients 
need  to  download  to  use  the  lookup  service .  For 
example,  you  might  specify  a  URL  to  the  HTTP  server  you 
started  earlier,  that  is,  http :  /  /hostname  .-port/reggie- 
dl.jar,  where  hostname  is  the  name  or  IP  address  of  the 
machine  on  which  the  HTTP  server  is  running,  and  port 
is  the  port  number  at  which  it  is  running.  You  also 
need  to  ensure  that  the  specified  HTTP  server  can 
access  reggie-dl. jar  under  its  document  root  directory. 
To  test  to  make  sure  the  JAR  file  is  accessible,  you 
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can  try  accessing  it  from  a  browser,  using  the  codebase 
URL.  Since  you  started  the  web  server  in  verbose  mode, 
you  should  see  a  request  logged  to  its  screen,  and 
you'll  most  likely  see  a  "Save  To"  dialog  box  (unless 
the  browser  has  been  configured  to  handle  .jar  files) . 

The  next  option,  lookup-policy- file,  specifies  another 
security  policy  file.  The  first  security  policy  file 
you  specified  is  used  only  by  the  setup  JVM,  while  this 
second  (potentially  different)  security  policy  file  is 
used  by  the  server  JVM  whenever  the  lookup  service  is 
reactivated. 

The  next  parameter,  log -directory,  specifies  an  absolute 
path  name  to  a  directory  (on  the  file  system  where  the 
lookup  service  is  running)  where  the  lookup  service 
writes  its  logs.  It's  important  to  point  out  that  this 
directory  should  not  already  exist,  or  the  setup  JVM 
will  exit  without  registering  the  lookup  service. 

The  final,  optional  parameter,  lookup-group,  is  used  to 
specify  a  "group"  of  services  for  which  reggie  provides 
lookup  service.  Usually,  you  use  the  special  group  name 
public,  which  Jini  services  conventionally  join;  if  you 
omit  the  parameter,  the  default  is  public. 

Here  is  an  example  command  for  starting  the  reggie 
lookup  service  on  Windows : 

java  -D java. security .policy=C : \ j inil_0_l\example\lookup\policy . all 
-jar  C:\jinil_0_l\lib\reggie.jar 
http : / /hostname: 8081/reggie-dl . j  ar 
C : \ j inil_0_l\example\lookup\policy . all 
C:\tmp\reggie_log 
public 

where  hostname  is  the  name  or  IP  address  of  the  machine 
on  which  the  HTTP  server  is  running. 

Here  is  what  the  example  command  looks  like  on  the 
Solaris  platform: 

java  -Dj ava. security. policy=/jinil_0_l/example/lookup/policy. all 
-jar  /jinil_0_l/lib/reggie. jar 
http: / /hostname: 8081/reggie-dl. jar 
/jinil_0_l/example/lookup/policy . all 
/ tmp/ reggie_log 
public 

You  should  note  that  using  the  policy. all  file  as  shown 
is  fine  when  you're  experimenting  with  your  code,  but 
it's  not  recommended  for  production  use,  since  it 
grants  all  permissions  to  all  code  (trusted  or  not)  . 
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When  deploying  your  code  in  a  production  environment, 
make  sure  you've  devised  careful  policies  that  restrict 
access  appropriately  (for  instance,  your  policy  might 
state  that  downloaded  code  cannot  access  certain  parts 
of  your  file  system) .  The  topic  of  security  in  the  Java 
2  platform  is  beyond  the  scope  of  this  article. 


Starting  a  Transaction  Manager 

If  your  JavaSpaces  applications  make  use  of 
transactions,  you'll  need  to  start  a  transaction 
manager  service  next,  with  a  command  of  the  form: 

java  -Djava.  security  .policy  =security-policy-file 
-Dcom .  sun .  j  ini .  mahalo .  managerName=  txnmanager-name 
-jar  C:\jinil_0_l\lib\mahalo.jar 
txnmanager- codebase 
securi ty-policy-file 
log-directory 
[  I  ookup  -  group ] 

(Note  that,  if  you're  using  an  RMI  registry  instead  of 
the  Jini  Lookup,  you'll  need  to  modify  the  command 
slightly;  refer  to 

C:\jinil_O_l\doc\example\StartingService.html . ) 

The  executable  JAR  file  containing  Sun's  implementation 
of  the  Transaction  Manager  Service  (called  "mahalo")  is 
C:\jinil_o_l\lib\mahalo.jar.  Like  the  lookup  service,  the 
transaction  manager  service  is  activatable:  When  the 
command  above  is  run,  a  "setup  JVM"  registers  the 
transaction  manager  with  the  RMI  activation  daemon- - 
which  activates  the  manager  in  a  newly  spawned  "server 
JVM" --and  then  exits.  Once  again,  the  command  line 
returns  once  the  registration  is  complete,  and  you 
should  see  a  command  prompt. 

The  security-policy-file  options  mean  what  you  would 
expect,  given  our  previous  discussion  about  starting 
the  Jini  Lookup  Service:  The  -Djava. security. policy  option 
governs  the  permissions  the  setup  JVM  uses,  while  the 
second  security-policy- file  option  specifies  the 
permissions  that  the  server  JVM  uses  whenever  the 
Transaction  Manager  Service  is  activated. 

The  option  -Dcom.  sun.  jini.  mahalo.  managerName  allows  you  to 
specify  a  name  (such  as  " Transact ionManager " )  for  the 
transaction  manager  if  you  wish:  this  name  becomes  an 
attribute  attached  to  the  transaction  manager  in  the 


143 


lookup  service,  and  can  be  used  to  look  up  this 
particular  transaction  service  later  on. 

Just  as  you  did  with  the  lookup  service,  you  need  to 
supply  a  codebase  option  to  the  service,  specifying  a 
URL  to  the  mahalo-dl. jar  file,  which  contains  the  code 
that  clients  need  to  download  to  use  the  transaction 
manager  service.  For  example,  you  might  supply  a  URL 
pointing  to  the  hostname  and  port  number  of  the  HTTP 
server  you  started  earlier.  Be  sure  that  the  specified 
HTTP  server  can  access  mahalo-dl  .jar  under  its  root 
directory.  Once  again,  you  may  want  to  try  accessing 
the  JAR  file  using  a  web  browser  and  your  codebase  URL, 
to  make  sure  the  file  is  accessible. 

The  next  parameter,  log-directory,  should  specify  an 
absolute  path  name  to  a  directory  (on  the  file  system 
where  the  Transaction  Manager  service  is  running)  where 
the  service  writes  its  logs.  You  should  make  sure  that 
the  log  file  doesn't  already  exist. 

For  the  last  (optional)  parameter,  you  can  specify  the 
name  of  a  Jini  group  for  the  Transaction  Manager  to 
join;  for  example,  public  means  the  manager  should 
become  part  of  the  public  group. 

Here's  an  example  of  starting  a  Transaction  Manager, 
using  the  Jini  Lookup  service,  on  Windows: 

java  -Djava . security .policy=C : \ j inil_0_l\example\txn\policy . all 
-jar  C:\jinil_0_l\lib\mahalo.jar 
http : / /hostname: 8081/mahalo-dl .jar 
C : \ j inil_0_l\example\txn\policy . all 
C : \tmp\txn_log 
public 

where  again,  hostname  is  the  name  or  IP  address  of  the 
machine  on  which  the  HTTP  server  is  running.  On 
Solaris,  the  command  looks  like  this: 

java  -Djava. security .policy=/j inil_0_l/example/txn/policy. all 
-jar  /jinil_0_l/lib/mahalo. jar 
http : / /hostname: 8081/mahalo-dl .jar 
/ j inil_0_l/example/txn/policy . all 
/tmp/txn_log 
public 


Starting  a  JavaSpaces  Service 

Now  that  you've  started  all  the  supporting  services 
(HTTP  Server,  RMI  Activation  Daemon,  Jini  Lookup 
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Service,  and  Transaction  Manager  Service) ,  you  can 
finally  start  a  JavaSpaces  service  (Sun's 
implementation  is  known  as  "outrigger").  You  can  choose 
to  start  either  a  JavaSpaces  service  called 
TransientSpace  (one  that  doesn't  maintain  data  across 
crashes  and  restarts  of  the  space)  or  a  persistent 
JavaSpaces  service  called  FrontEndSpace  (one  that  does 
maintain  data  across  crashes  and  restarts) . 

Starting  a  Transient  JavaSpace 

To  start  a  TransientSpace  JavaSpaces  service,  given  that 
you're  running  a  Jini  Lookup  Service,  the  command  takes 
the  following  form: 

j ava  - D j ava . security . pol icy= securi ty-pol icy- file 
-D j  ava . rmi . server . codebase= ja  vaspace-codebase 
-Dcom. sun. j ini .outrigger . spaceName=space-name 
-jar  C : \ j ini 1_0_1 \ 1 ib\ trans ient -out rigger . j ar 
[  1  ookup  -  group] 

(Refer  to  C:\jinil_O_l\doc\example\StartingService.html  for 
the  details  of  formatting  the  command  if  you're  using 
an  RMI  registry  instead.) 

Let's  examine  the  parameters.  The  security-policy- file 
option  governs  the  permissions  the  JVM  uses  when 
running  the  JavaSpaces  service.  The  javaspace-codebase 
option  specifies  a  URL  that  points  to  the  outrigger- 
dl. jar  code  that  clients  must  download  in  order  to  use 
the  JavaSpaces  service.  The 

Dcom.  sun.  jini.  outrigger.  spaceName  option  is  used  to  specify 
a  name  for  the  JavaSpaces  service  (for  example, 
"JavaSpaces").  And  as  you  saw  with  the  transaction 
manager  service,  you  can  optionally  specify  the  name  of 
a  Jini  community  for  this  service  to  join. 

It's  worth  noting  here  that  a  transient  JavaSpace 
service  is  not  an  activatable  service,  and  the  command 
above  is  handled  by  just  a  single  JVM.  This  is  why  you 
don't  need  to  pass  additional  arguments  ( codebase , 
security-policy-  file ,  log-directory)  at  the  end  of  the 
command  as  you  did  for  the  lookup  service  and 
transaction  manager  service.  The  JVM  that  executes  the 
command  will  continue  to  run  until  the  JavaSpaces 
service  exits  or  gets  killed,  so  unlike  the  activatable 
services,  you  will  not  be  returned  to  the  command 
prompt  while  the  space  is  running. 
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Here's  an  example  of  starting  a  transient  JavaSpace, 
using  the  Jini  Lookup  service,  on  Windows: 

java  -Djava. security. policy=C:\jinil_0_l\example\books\policy. all 
-Djava . rmi . server . codebase=http : / /hostname: 808 1/outrigger-dl .jar 
-Doom. sun . j ini . outrigger . spaceName= JavaSpaces 
-jar  C : \ j inil_0_l\lib\transient -outrigger . j ar 
public 

On  the  Solaris  platform,  the  equivalent  command  looks 
like  this: 

java  -Dj ava . security .policy=/ j inil_0_l/ example/books/policy . all 
-Djava . rmi . server . codebase=http : / /hostname: 808 1/outrigger-dl .jar 
-Dcom . sun . j ini . outrigger . spaceName= JavaSpaces 
-jar  / j ini 1_0_1/ 1 ib/trans ient - outrigger . j  ar 
public 

Again,  you  should  note  that  the  policy. all  file  is  fine 
for  your  code  experimentation,  but  you  should  revisit 
the  security  policy  issue  when  you  deploy  your  code  in 
a  production  environment. 

Starting  a  Persistent  Javaspace 

In  a  deployment  environment,  you're  likely  going  to 
want  to  run  a  persistent  FrontEndSpace  JavaSpaces  service 
rather  than  a  transient  JavaSpaces  service.  A 
FrontEndSpace  is  able  to  maintain  its  data,  even  through 
crashes  and  restarts  of  the  space. 

To  start  a  FrontEndSpace  JavaSpaces  service,  given  that 
you're  running  a  Jini  Lookup  Service,  the  command  takes 
the  following  form: 

j  ava  -D j  ava . security . policy =securi ty-policy-file 
-Dcom. sun . j ini . outrigger . spaceName=space-name 
-jar  C : \ j inil_0_l\lib\outrigger . jar 
javaspace-codebase 
securi ty-pol icy- file 
log- directory 
[lookup -group] 

Since  FrontEndSpace  is  an  activatable  JavaSpaces  service, 
you'll  notice  some  differences  from  starting  a 
transient  space.  First,  the  codebase  is  specified 
differently.  Second,  you  must  supply  a  second  security 
policy  file  (as  you  did  when  starting  the  lookup 
service  and  the  transaction  manager,  to  be  used  when 
the  service  is  reactivated  by  the  RMI  Activation 
Daemon) .  Last,  you  must  supply  an  absolute  path  name  to 
a  directory  where  the  JavaSpaces  service  writes  log 
files . 
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Note  that  outrigger. jar  contains  all  the  classes  needed, 
for  the  JavaSpaces  service  to  run  a  FrontEndSpace .  Here's 
an  example  of  starting  a  FrontEndSpace,  using  a  Jini 
Lookup  service,  on  the  Windows  platform: 

j ava  -Dj ava . security .policy=C : \ j inil_0_l\example\books\policy . all 
-jar  C : \ j inil_0_l\lib\outrigger . j ar 
http : / /hostname : 8 0 8 1/outrigger-dl . j  ar 
-Dcom. sun. j ini . outrigger . spaceName= JavaSpaces 
C : \ j ini 1_0_1\ examp le\books\pol icy . all 
C:\tmp\j  s_log 
public 

Here ' s  an  example  of  starting  a  FrontEndSpace  on 
Solaris : 

java  -Djava. security .policy=/jinil_0_l/example/books/policy .all 

-jar  / j inil_0_l/lib/ outrigger . j  ar 

http : / /hostname: 80 8 1/outrigger-dl . j  ar 

-Dcom. sun. j ini . outrigger . spaceName= JavaSpaces 

/ j inil_0_l/example/books/policy . all 

/tmp/js_log 

public 

As  you  saw  with  other  activatable  services,  issuing 
these  commands  returns  a  command  prompt . 

Compiling  JavaSpaces  Programs 

By  now,  you  have  all  the  required  Jini  services  up  and 
running.  Assuming  you've  already  written  a  JavaSpaces  client 
program  (one  that  makes  use  of  a  JavaSpaces  service)  ,  all 
that's  left  is  to  compile  your  code  and  run  it. 

If  you  wish,  you  can  experiment  with  a  very  simple  "  Hello 
World  "  program  from  JavaSpaces  Principles ,  Patterns  and 
Practice .  You  need  to  edit  the  compile.bat  file  and  replace 
localhost : 8081  with  the  IP  address  and  port  number  of  your  web 
server,  and  then  you  can  simply  run  compile.bat  and  runit.bat 
to  get  the  example  up  and  running  under  Windows. 

When  compiling  JavaSpaces  programs,  the  javac  compiler  (and 
later  the  java  bytecode  interpreter)  may  need  access  to 
several  different  jar  files: 

•  jini-core.  jar,  which  contains  the  core  Jini  interfaces 
and  classes  and  is  needed  whenever  your  program  makes 
use  of  leases  or  events,  for  example. 

•  jini-ext.  jar,  which  contains  additional  interfaces  that 
are  useful  in  building  Jini  applications,  including  the 
JavaSpaces  interface. 
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•  sun-util,  jar,  which  contains  a  set  of  useful  helper 
utilities .  These  classes  may  change,  however,  since 
they  are  regarded  as  non-standard. 

•  space -examples,  jar,  which  contains  various  JavaSpaces 

technology  examples  and  includes  the  classes 

com. sun. j ini .mahout .Locator,  com. sun. j ini .outrigger . LookupFinder , 
and  com.  sun.  j  ini.  outrigger.  Finder,  which  are  needed  when 
compiling  the  SpaceAccessor. java  code  found  in  Chapter  1 
of  the  JavaS^acesTM  Princi£les_,  Patterns  and  Practice 
<http://www. amazon . com/ exec/obidos/ASIN/ 0201309556 /> . 

When  compiling  your  JavaSpaces  programs,  supply  a  -classpath 
option  to  the  javac  compiler.  For  example,  to  compile 
ExampieProgram. java  on  Windows,  the  command  miqht  look  like 
this: 

javac  -d  .  -classpath 

C : \ j inil_0_l\lib\ j ini -core . j  ar; 

C : \ j inil_0_l\lib\ j ini -ext . jar ; 

C : \ j inil_o_l\lib\ sun-util .jar; 

C:\jinil_0_l\lib\space-examples.jar; . ; 

ExampieProgram. j ava 

Note  that  these  JAR  files  might  not  all  be  necessary  for 
every  compilation;  it  depends  on  the  specifics  of  the 
program  you're  compiling.  Also  note  the  use  of  the  -d 
option;  here  it  is  used  to  specify  that  class  files  should 
be  created  in  the  current  directory.  The  appearing  at  the 
end  of  the  classpath  option  indicates  that  the  current 
directory  is  searched  for  classes,  along  with  the  JAR  files 
listed.  You  should  tailor  these  options  according  to  where 
you  want  your  class  files  stored. 

On  Solaris,  the  equivalent  command  looks  like  this: 

javac  -d  .  -classpath 

/  j  inil__0_l/lib/  j  ini -core  .  jar: 

/ j inil_0_l/lib/ j ini -ext .jar: 

/ j inil_0_l/lib/ sun-util .jar: 

/jinil_0_l/lib/space-examples, jar: . : 

ExampieProgram . j  ava 

Alternately,  you  could  specify  the  required  JAR  files  in  the 
CLASSPATH  environment  variable  or  place  JAR  files  in  the 
Java  extensions  folder.  However,  during  the  code  development 
phase- -when  you're  likely  running  a  JavaSpaces  service  and 
client  programs  on  the  same  machine- -avoiding  these 
modifications  to  the  classpath  environment  is  a  good  policy: 

helps  to  avoid  unintended  sharing  of  class  files,  and  to 
simulate  a  deployment  environment --when  Jini  services,  such 
as  a  JavaSpace,  and  client  programs  that  make  use  of  them 
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are  likely  to  run  on  different  machines.  Avoiding  use  of  the 
CLASSPATH  and  Java  extensions  can  help  to  reduce  the 
problems  you'll  encounter  when  you  move  from  development  to 
deployment . 


Running  JavaSpaces  Programs 

Now  that  you've  compiled  your  JavaSpaces  programs,  you're 
ready  to  run  them.  Assuming  you're  running  the  Jini  Lookup 
service  on  the  Windows  platform,  the  command  takes  this 
form: 

j ava  -Dj ava . security .policy=C : \ j inil_0_l\example\books\policy . all 
-Doutrigger . spacename= JavaSpaces 
-Dcom . sun . j ini . lookup . groups=public 
-cp  C:\jinil_0_l\lib\space-examples.jar; 

C : \ j inil_0_l\lib\ j ini-core .jar; 

C : \ j inil_0_l\lib\ j ini-ext .jar; 

-Djava . rmi . server . codebase=http : //hostname: 8081/space-examples-dl . j  ar 
ExampleProgram 

On  Solaris,  the  command  takes  this  form: 

j  ava  -D j  ava . security . policy=/ j inil_0_l/example/books/policy . all 
-Doutrigger . spacename= JavaSpaces 
-Dcom. sun. j ini . lookup ,groups=public 
-cp  / j inil_0_l/lib/ space -examples .jar: 

/ j inil_0_l/lib/ j ini -core . jar : 

/ j inil_0_l/lib/ j ini -ext . jar : 

-D j  ava . rmi . server . codebase=http : / /hostname : 8081/ space-examples -dl . j  ar 
ExampleProgram 

Let ' s  take  a  look  at  each  of  the  parameters .  The 
Djava. security. policy  option  specifies  the  path  to  the  security 
policy  file  you'd  like  your  program  to  use  when  it  runs 
downloaded  code  (for  example,  if  your  program  retrieves  an 
entry  from  a  JavaSpace  and  invokes  one  of  its  methods)  .  If 
you  find  none  of  the  policy  files  provided  in  the  Jini 
distribution  to  be  suitable,  you'll  have  to  modify  one  to 
meet  your  needs . 

With  the  -Doutrigger . spacename  option,  you  can  specify  the  name 
of  the  specific  JavaSpaces  service  you'd  like  your  program 
to  use  (with  the  command  above,  you're  specifying  that  your 
program  should  interact  with  a  space  called  "JavaSpaces",  if 
one  can  be  found,  not  one  called  "Old  JavaSpace"  or  anything 
else . 

The  -Dcom.  sun.  jini.  lookup,  groups  option  specifies  which  Jini 
community  this  program  runs  under  (here,  the  public  group) . 
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The  Java  bytecode  interpreter  (java)  needs  access  to  several 
JAR  files;  the  exact  ones  depend  on  what  your  program  does. 
Refer  to  the  list  of  JAR  files  in  Compiling  JavaSpaces 
Programs . 

The  codebase  property  needs  to  be  set  if  your  program  is 
exporting  downloadable  code,  for  instance  if  your  program  is 
writing  entries  into  a  JavaSpace.  In  this  case,  when  other 
programs  read  or  remove  those  entries,  they  need  to  know 
where  they  can  download  the  classes  for  those  entries.  This 
information  is  provided  by  your  program,  which  annotates  the 
entries  it  writes  into  the  space  with  information  from  the 
codebase  property.  The  codebase  property  also  needs  to  be  set 
if  your  program  is  requesting  notification  services  from  any 
of  the  Jini  services;  in  this  case  the  "listener"  code  needs 
to  be  exported. 
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